Seedance 2.5 Flash API
本文件提供字節跳動 Seedance 2.5 Flash 影片生成模型的完整 API 參考資料。
模型版本
此 API 支援以下三個模型版本:
快速比較
支援的寬高比
文字生成影片與參考素材生成影片支援以下寬高比:
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
圖片生成影片不支援 aspect_ratio 參數。
解析度選項
Seedance 2.5 Flash Text to Video
API 端點
POST /api/v1/video/task
請求參數
必填參數
選填參數
請求範例
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
請求參數
必填參數
選填參數
圖片生成影片模型不支援 aspect_ratio,請勿在請求中傳入這個參數。
請求範例
{
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
請求參數
必填參數
參考素材
所有參考素材皆為選填。可以只提供圖片、只提供影片、只提供音訊,也可以不提供任何參考素材。無需參考素材時,建議使用文字生成影片模型。
@ (AT) 引用預留位置
@ (AT) 引用功能透過帶有編號的 <<<...>>> 預留位置,在提示詞中指定參考素材。每種素材皆獨立從 1 開始編號,順序與對應的陣列相同:
例如,若第一張圖片用來參考角色,第二張用來參考場景,可在 prompt 中以 <<<image_1>>> 指定角色,以 <<<image_2>>> 指定場景。每個預留位置都必須指向對應陣列中實際存在的項目。
選填參數
請求範例
{
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) 引用的參考素材生成影片請求範例
{
model_name: 'seedance-v2.5-flash-reference-to-video',
prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
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']
}
素材限制
以下限制適用於本頁模型使用的首格影像、尾格影像與參考素材。
參考音訊與參考影片的總長度分開計算,每類最多 30 秒。各類素材的數量也獨立計算:最多可提供 10 張圖片、5 段影片與 5 段音訊。
所有模型都必須指定 resolution 和 duration,這兩個參數均無預設值。文字生成影片與參考素材生成影片在省略 aspect_ratio 時皆採用 16:9。聲音開關預設為 true,設為 false 即可生成無聲影片。
回應格式
初始回應
所有模型都會傳回 task_id,供輪詢時使用:
{
"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} 以查詢任務狀態:
{
"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 秒輪詢一次,查詢任務狀態。
最佳實務
- 必填參數:請務必提供
prompt、resolution 和 duration。文字生成影片與參考素材生成影片的 aspect_ratio 參數為選填,預設值為 16:9
- 圖片生成影片的寬高比:請勿在圖片生成影片的請求中傳入
aspect_ratio
- 參考影片:影片為選填,每段影片的長度與影片總長度均須符合本文件規定的限制
- 參考圖片:圖片為選填,可獨立於影片與音訊提供。最多可提交 10 個支援格式的圖片 URL
- 參考音訊:每段音訊的長度須為 2–30 秒,檔案大小不得超過 15 MB,總長度不得超過 30 秒
- 參考素材順序:依預期的引用順序排列
images、videos 和 audios 中的項目,並在提示詞中依該順序引用
- 聲音:省略
sound 即可使用預設值 true,設為 false 可關閉聲音生成