Skip to main content
POST
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。
  • 字節跳動豆包視頻生成模型 1.5 Pro 版本
  • 支持文本到視頻生成
  • 支持首幀/尾幀圖控制
  • 不支持參考圖模式
  • 支持音頻生成(1.5 Pro 獨有功能)
  • 異步任務管理,通過任務 ID 查詢結果

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"doubao-seedance-1-5-pro"
必填
視頻生成模型名稱可用模型:
  • doubao-seedance-1-5-pro - 1.5 Pro 版,支持音頻生成和首幀/尾幀控制
boolean
預設值:false
選填, 預設 false. 設為 true 時依所選渠道能力準備並審核素材; 不支援私有素材庫的渠道略過提審, 沿用原有生成流程.僅用於包含以下媒體欄位的非同步生成請求: image_urls, image_with_roles.純文字或僅在 metadata 中提供素材的請求請省略或設為 false. 不適用於獨立的 remix 或 extend API. 設為 true 時拒絕 asset://, 模型原有的媒體格式與數量限制不變. 詳見按需素材審核.
string
必填
視頻內容描述詳細描述場景、動作、風格以獲得更好的生成效果示例:"海灘日落,金色陽光照在海面上,海浪輕輕拍打沙灘"
integer
預設值:5
視頻時長(秒)支持範圍:4 ~ 12 秒默認:5
string
預設值:"16:9"
視頻寬高比可選項:
  • 16:9 - 橫屏
  • 9:16 - 豎屏
  • 1:1 - 方形
  • 4:3 - 傳統比例
  • 3:4 - 豎向傳統比例
  • 21:9 - 超寬屏
默認:16:9

分辨率與寬高比組合

string[]
兼容圖片 URL 數組,用於首尾幀圖生視頻兼容規則:
  • 1 張圖片:作爲 first_frame
  • 2 張圖片:分別作爲 first_frame 和 last_frame
  • 超過 2 張:僅使用前兩張,其餘忽略
建議優先使用 image_with_roles 顯式指定首幀和尾幀示例:["https://example.com/first.png", "https://example.com/last.png"]image_urls 和 image_with_roles 不能同時使用
array
帶角色的圖像數組,用於顯式首尾幀控制示例:
  • image_urls 和 image_with_roles 不能同時使用
  • 首幀和尾幀僅支持各一張
  • 1.5 Pro 不支持 reference_image(參考圖)角色,如需參考圖功能請使用 Seedance 2.0
object
擴展參數

與 1.0 版本的差異

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間戳(Unix 時間戳)
object
任務元數據