申請流程
要使用 API，需要先到 SeeDance Videos Generation API 對應頁面申請對應的服務，進入頁面之後，點擊「Acquire」按鈕，如圖所示：
如果你尚未登入或註冊，會自動跳轉到登入頁面邀請您來註冊和登入，登入註冊之後會自動返回當前頁面。
在首次申請時會有免費額度贈送，可以免費使用該 API。
基本使用
首先先了解下基本的使用方式，就是輸入提示詞content.text、類型content.type=text 以及模型 model，便可獲得處理後的結果，具體的內容如下：
accept：想要接收怎樣格式的響應結果，這裡填寫為application/json，即 JSON 格式。authorization：調用 API 的密鑰，申請之後可以直接下拉選擇。
model：生成視頻的模型，可選值：doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015、doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428。content：輸入內容數組，type可以是text或image_url。resolution：輸出分辨率，可選480p/720p/1080p。ratio：寬高比，可選16:9/4:3/1:1/3:4/9:16/21:9/adaptive。duration：視頻時長（秒），範圍 2–12。seed：隨機種子，整數，-1 到 4294967295。camerafixed：是否固定攝像頭，true/false。watermark：是否添加水印，true/false。generate_audio：是否生成有聲視頻，true/false，僅doubao-seedance-1-5-pro-251215支持。service_tier：推理模式，default（在線）或flex（離線，價格為在線的 50%）。return_last_frame：是否在結果中返回視頻最後一幀圖片 URL。execution_expires_after：任務超時時間（秒），範圍 3600–259200。callback_url：異步回調地址，設置後 API 立即返回task_id，任務完成時將結果 POST 到該地址。
success，此時視頻生成任務的狀態情況。task_id，此時視頻生成任務ID。trace_id，此時視頻生成跟蹤ID。data，此時視頻生成任務的結果列表。task_id，此時視頻生成任務的伺服器端ID。video_url，此時視頻生成任務的視頻鏈接。status，此時視頻生成任務的狀態。model，生成視頻使用的模型。
data 的視頻鏈接地址獲取生成的SeeDance視頻即可。
另外如果想生成對應的對接代碼，可以直接複製生成，例如 CURL 的代碼如下：
內聯參數說明
在content[].text 提示詞末尾，可以透過追加 --parameter value 的形式傳入生成參數（舊方式，弱校驗，填寫有誤時自動使用默認值）。完整參數列表如下：
| 內聯參數 | 對應字段 | 說明 | 取值範圍 |
|---|---|---|---|
--rs | resolution | 輸出分辨率 | 480p / 720p / 1080p |
--rt | ratio | 寬高比 | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive |
--dur | duration | 視頻時長（秒） | 2–12 |
--frames | frames | 視頻幀數 | [29, 289] 中滿足 25+4n 的整數 |
--fps | framespersecond | 幀率 | 僅支持 24 |
--seed | seed | 隨機種子 | -1 到 4294967295 |
--cf | camerafixed | 是否固定攝像頭 | true / false |
--wm | watermark | 是否添加水印 | true / false |
推薦做法：直接在 Request Body 中使用對應的頂層字段（如resolution、ratio等），為強校驗模式，參數填寫有誤時會返回明確錯誤提示，更易於排查問題。
生成有聲視頻
doubao-seedance-1-5-pro-251215 支持透過 generate_audio 參數生成帶音頻的視頻：
图生视频首帧
如果想图生视频任务，首先content 参数需要包含 type 为 image_url 的项，image_url 字段必须为对象格式：{"url": "https://..."} 或 Base64 格式 {"url": "data:image/png;base64,..."}。
注意：对应的代码：image_url不支持直接传入字符串格式（如"image_url": "https://..."），必须使用对象格式"image_url": {"url": "https://..."}，否则会返回 400 错误。
图生视频首尾帧
如果想图生视频首尾帧， 首先参数content必须传入类型image_url,并且分别设置role为first_frame和last_frame，就可以指定如下内容：
- role：指定首帧或者尾帧。
- image_url
- url 图片链接
同时
content还需要输入类型text作为prompt提示词
- url 图片链接
同时
异步回调
由于 SeeDance Videos Generation API 生成时间较长（约 1-2 分钟），可通过callback_url 字段使用异步模式，避免 HTTP 连接长时间占用。
整体流程：客户端发起请求时指定 callback_url，API 立即返回包含 task_id 的响应；任务完成后，平台将生成结果以 POST JSON 的形式发送到 callback_url，结果中同样包含 task_id 以便关联。
callback_url 的内容如下：
task_id 字段与请求时返回的一致，通过该字段即可实现任务的关联。
错误处理
在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：400 token_mismatched：错误请求，可能是由于缺少或无效的参数。400 api_not_implemented：错误请求，可能是由于缺少或无效的参数。401 invalid_token：未授权，授权令牌无效或缺失。429 too_many_requests：请求过多，您已超出速率限制。500 api_error：内部服务器错误，服务器出现问题。