# Seedance 2.5 Flash API 本文件提供字節跳動 Seedance 2.5 Flash 影片生成模型的完整 API 參考資料。 ## 模型版本 此 API 支援以下三個模型版本: | 模型 | ID | 說明 | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | 根據文字生成高品質影片 | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | 根據首格影像或首尾兩格影像生成影片 | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | 依據參考圖片、影片與音訊生成影片 | ## 快速比較 | 功能 | 文字生成影片 | 圖片生成影片 | 參考素材生成影片 | |---------|---------------|----------------|--------------------| | 長度範圍 | 4–30 秒 | 4–30 秒 | 4–30 秒 | | 解析度選項 | 480p、720p | 480p、720p | 480p、720p | | 寬高比 | 選填(預設 16:9) | 不支援 | 選填(預設 16:9) | | 必要素材 | 無 | 首格影像 | 無 | | 選用素材 | 無 | 尾格影像 | 圖片、影片與音訊 | ### 支援的寬高比 文字生成影片與參考素材生成影片支援以下寬高比: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 圖片生成影片不支援 `aspect_ratio` 參數。 ### 解析度選項 | 解析度 | 說明 | |------------|-------------| | `480p` | 標準畫質 | | `720p` | 高畫質 | ## Seedance 2.5 Flash Text to Video ### API 端點 ``` POST /api/v1/video/task ``` ### 請求參數 #### 必填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `model_name` | string | 必須為 `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | 影片生成提示詞,最多 5000 個字元 | | `resolution` | string | 輸出解析度為 `"480p"` 或 `"720p"`,無預設值 | | `duration` | integer | 影片長度為 4–30 秒,以 1 秒為單位指定整數值,無預設值 | #### 選填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `aspect_ratio` | string | 影片寬高比,可選 `"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"` 或 `"3:4"`。預設為 `"16:9"` | | `sound` | boolean | 是否生成聲音。預設為 `true`,設為 `false` 則生成無聲影片 | ### 請求範例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### 請求參數 #### 必填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `model_name` | string | 必須為 `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | 影片生成提示詞,最多 5000 個字元 | | `resolution` | string | 輸出解析度為 `"480p"` 或 `"720p"`,無預設值 | | `duration` | integer | 影片長度為 4–30 秒,以 1 秒為單位指定整數值,無預設值 | | `image_url` | string | 首格影像的 URL,詳見下方的素材限制。輸出影片沿用這張圖片的寬高比 | #### 選填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `image_end_url` | string | 選填的尾格影像 URL,詳見下方的素材限制。建議使用與首格影像相同的寬高比 | | `sound` | boolean | 是否生成聲音。預設為 `true`,設為 `false` 則生成無聲影片 | > 圖片生成影片模型不支援 `aspect_ratio`,請勿在請求中傳入這個參數。 ### 請求範例 ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### 請求參數 #### 必填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `model_name` | string | 必須為 `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | 影片生成提示詞,最多 5000 個字元。可撰寫不含預留位置的普通提示詞,也可使用 @ (AT) 引用功能,透過 `<<>>`、`<<>>` 和 `<<>>` 明確指定對應素材陣列中的項目 | | `resolution` | string | 輸出解析度為 `"480p"` 或 `"720p"`,無預設值 | | `duration` | integer | 影片長度為 4–30 秒,以 1 秒為單位指定整數值,無預設值 | #### 參考素材 所有參考素材皆為選填。可以只提供圖片、只提供影片、只提供音訊,也可以不提供任何參考素材。無需參考素材時,建議使用文字生成影片模型。 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `images` | string[] | 0–10 個參考圖片 URL,依陣列順序引用,詳見下方的素材限制 | | `videos` | string[] | 0–5 個 MP4 或 MOV 格式的參考影片 URL。每段影片長度須為 2–30 秒,合計不得超過 30 秒,詳見下方的素材限制。計費時先將參考影片的總長度四捨五入至整秒(滿半秒進位),再加上輸出影片的長度 | | `audios` | string[] | 0–5 個 WAV 或 MP3 格式的參考音訊 URL。每段音訊長度須為 2–30 秒,檔案大小不得超過 15 MB,總長度不得超過 30 秒 | #### @ (AT) 引用預留位置 @ (AT) 引用功能透過帶有編號的 `<<<...>>>` 預留位置,在提示詞中指定參考素材。每種素材皆獨立從 `1` 開始編號,順序與對應的陣列相同: | 預留位置 | 引用的值 | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | 例如,若第一張圖片用來參考角色,第二張用來參考場景,可在 `prompt` 中以 `<<>>` 指定角色,以 `<<>>` 指定場景。每個預留位置都必須指向對應陣列中實際存在的項目。 #### 選填參數 | 參數 | 型別 | 說明 | |-----------|------|-------------| | `aspect_ratio` | string | 影片寬高比,可選 `"21:9"`、`"16:9"`、`"9:16"`、`"1:1"`、`"4:3"` 或 `"3:4"`。預設為 `"16:9"` | | `sound` | boolean | 是否生成聲音。預設為 `true`,設為 `false` 則生成無聲影片 | ### 請求範例 ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### 使用 @ (AT) 引用的參考素材生成影片請求範例 ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## 素材限制 以下限制適用於本頁模型使用的首格影像、尾格影像與參考素材。 | 素材 | 格式 | 限制 | |-------|---------|--------| | 圖片 | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | 每張須小於 30 MB,寬與高均須介於 300–6000 像素,寬高比須介於 0.4–2.5 | | 影片 | MP4, MOV | 每段最多 200 MB,寬與高均須介於 300–6000 像素,寬高比須介於 0.4–2.5,影格率須為 24–60 FPS,總像素數須介於 407696–8295044 | | 音訊 | WAV, MP3 | 每段最多 15 MB | 參考音訊與參考影片的總長度分開計算,每類最多 30 秒。各類素材的數量也獨立計算:最多可提供 10 張圖片、5 段影片與 5 段音訊。 所有模型都必須指定 `resolution` 和 `duration`,這兩個參數均無預設值。文字生成影片與參考素材生成影片在省略 `aspect_ratio` 時皆採用 `16:9`。聲音開關預設為 `true`,設為 `false` 即可生成無聲影片。 ## 回應格式 ### 初始回應 所有模型都會傳回 `task_id`,供輪詢時使用: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### 輪詢回應 輪詢 `GET /api/v1/video/{taskId}` 以查詢任務狀態: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### 狀態值 - `submitted`:已接受任務,正在等候處理 - `processing`:正在生成影片 - `succeed`:影片生成完成 - `failed`:影片生成失敗 ## 處理時間 處理時間取決於影片長度、解析度與目前的佇列狀況。 每隔 5–10 秒輪詢一次,查詢任務狀態。 ## 最佳實務 1. **必填參數**:請務必提供 `prompt`、`resolution` 和 `duration`。文字生成影片與參考素材生成影片的 `aspect_ratio` 參數為選填,預設值為 `16:9` 2. **圖片生成影片的寬高比**:請勿在圖片生成影片的請求中傳入 `aspect_ratio` 3. **參考影片**:影片為選填,每段影片的長度與影片總長度均須符合本文件規定的限制 4. **參考圖片**:圖片為選填,可獨立於影片與音訊提供。最多可提交 10 個支援格式的圖片 URL 5. **參考音訊**:每段音訊的長度須為 2–30 秒,檔案大小不得超過 15 MB,總長度不得超過 30 秒 6. **參考素材順序**:依預期的引用順序排列 `images`、`videos` 和 `audios` 中的項目,並在提示詞中依該順序引用 7. **聲音**:省略 `sound` 即可使用預設值 `true`,設為 `false` 可關閉聲音生成