Doubao SeeDance 視頻生成
使用字節跳動豆包 Doubao SeeDance 模型生成視頻
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。
- 字節跳動豆包視頻生成模型
- 通過 model 參數選擇
doubao-seedance-1-0-pro-fast或doubao-seedance-1-0-pro-quality模型 - 支持文本到視頻生成
- 支持首幀/尾幀/參考圖控制
- 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。
Authorizations
Authorizationstring請求頭必填所有接口均需要使用 Bearer Token 進行認證
獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key
使用時在請求頭中添加:
Authorization: Bearer YOUR_API_KEYBody
modelstring請求體必填預設值: doubao-seedance-1-0-pro-fast視頻生成模型名稱
可用模型:
doubao-seedance-1-0-pro-fast- 快速版(40-90 秒生成)doubao-seedance-1-0-pro-quality- 高質量版(90-300 秒生成)
promptstring請求體必填視頻內容描述
詳細描述場景、動作、風格以獲得更好的生成效果
示例:"海灘日落,金色陽光照在海面上,海浪輕輕拍打沙灘"
durationinteger請求體預設值: 5視頻時長(秒)
支持範圍:2 ~ 12 秒
默認:5
aspect_ratiostring請求體預設值: 16:9視頻寬高比
可選項:
16:9- 橫屏9:16- 豎屏1:1- 方形4:3- 傳統比例3:4- 豎向傳統比例21:9- 超寬屏
默認:16:9
resolutionstring請求體預設值: 720p視頻分辨率
可選項:
480p- 標清720p- 高清1080p- 全高清
默認:720p
1080p 限制:使用參考圖(image_with_roles 中 role: reference)時,不支持 1080p 分辨率
分辨率與寬高比組合
| 分辨率 | 支持的寬高比 | 備註 |
|---|---|---|
| 480p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 全部支持 |
| 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 全部支持 |
| 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | 不支持參考圖 |
image_urlsstring[]請求體首幀圖像 URL 數組,用於圖生視頻
⚠️ 僅支持 URL 格式(不再支持 base64)
- 公開可訪問的圖像 URL(http:// 或 https://)
- 可使用 上傳圖片接口 上傳本地圖片獲取 URL
示例:["https://example.com/cat.png"]
image_urls 和 image_with_roles 不能同時使用
image_with_rolesarray請求體帶角色的圖像數組,用於更精確的控制
字段說明
urlstring請求體必填圖像 URL 地址
rolestring請求體必填圖像角色
可選項:
first_frame- 首幀圖,作爲視頻起始畫面(僅支持一張)last_frame- 尾幀圖,作爲視頻結束畫面(僅 quality 版本支持,僅支持一張)reference- 參考圖,用於指導視頻風格(僅支持一張)
示例:
[
{"url": "https://example.com/start.png", "role": "first_frame"},
{"url": "https://example.com/end.png", "role": "last_frame"}
]image_urls和image_with_roles不能同時使用- 每種角色的圖片僅支持上傳一張
last_frame(尾幀圖)僅doubao-seedance-1-0-pro-quality版本支持,fast 版本不支持首尾幀同時使用
metadataobject請求體擴展參數(可選)
字段說明
seedinteger請求體種子整數,用於控制生成內容的隨機性
取值範圍:-1 ~ 2^32-1
相同 seed 值會生成類似結果,但不保證完全一致
素材審核
請求帶有圖片素材時, 部分渠道會在提交生成前自動審核素材. 無需額外參數, 在原有圖片欄位中傳入圖片 URL 即可.
- 請求受理後立即返回視頻任務. 需要審核時任務維持
queued, 本次請求的素材全部通過後才提交生成. 首次審核可能需要數分鐘, 同一使用者在同一渠道重複使用相同 URL 時會重用審核結果. - 每輪素材準備預設最長 20 分鐘. 素材被拒絕或準備逾時會結束任務, 狀態為
failed, 原因見error.message. 審核未通過不收取視頻生成費用. - 圖片須為公網 HTTP(S) URL, 不接受 Base64 與本機路徑, 建議不超過 30 MB; 模型原有的格式限制不變.
- 需要審核的渠道會在受理時驗證圖片 URL: 帶有帳號密碼或超過 2048 位元組時直接返回 HTTP 400,
error.code為invalid_private_assets. - 平台依 URL 識別素材. 檔案內容變更後請改用新的 URL.
- 舊的
asset://素材引用已停用, 會返回 HTTP 400.
Response
idstring任務唯一標識符,用於查詢任務狀態
objectstring對象類型,固定爲 generation.task
modelstring使用的模型名稱
statusstring任務狀態
queued- 排隊等待處理in_progress- 處理中completed- 成功完成failed- 失敗
progressinteger任務進度百分比(0-100)
created_atinteger任務創建時間戳(Unix 時間戳)
metadataobject任務元數據
請求示例
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-1-0-pro-fast",
"prompt": "海灘日落,金色陽光照在海面上,海浪輕輕拍打沙灘",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-1-0-pro-quality",
"prompt": "女孩在櫻花樹下旋轉,花瓣隨風飄落",
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "1080p"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-1-0-pro-quality",
"prompt": "畫面從白天逐漸過渡到夜晚,城市燈光逐漸亮起",
"duration": 5,
"image_with_roles": [
{"url": "https://example.com/day.png", "role": "first_frame"},
{"url": "https://example.com/night.png", "role": "last_frame"}
]
}'import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "doubao-seedance-1-0-pro-fast",
"prompt": "海灘日落,金色陽光照在海面上,海浪輕輕拍打沙灘",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
)
task = response.json()
print(f"任務 ID: {task['id']}")
print(f"狀態: {task['status']}")const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'doubao-seedance-1-0-pro-fast',
prompt: '海灘日落,金色陽光照在海面上,海浪輕輕拍打沙灘',
duration: 5,
aspect_ratio: '16:9',
resolution: '720p'
})
});
const task = await response.json();
console.log(`任務 ID: ${task.id}`);
console.log(`狀態: ${task.status}`);響應示例
{
"id": "task_vid_xyz789ghi012",
"object": "generation.task",
"model": "doubao-seedance-1-0-pro-fast",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}