申請流程
要使用 SeeDance Videos Generation API，首先到 Ace Data Cloud 控制台 獲取您的 API Token，留作備用。
如果你尚未登錄或註冊，會自動跳轉到登錄頁面邀請你註冊和登錄，完成後會自動返回當前頁面。
一個 API Token 即可調用平台所有服務，無需為每個服務單獨申請。 首次申請會贈送免費額度，可免費體驗；額度不足時可在 控制台 充值通用餘額。
📘 完整文檔：SeeDance Videos Generation API →
基本使用
首先先了解下基本的使用方式，就是輸入提示詞content.text、類型content.type=text 以及模型 model，便可獲得處理後的結果，具體的內容如下：
accept：想要接收怎樣格式的響應結果，這裡填寫為application/json，即 JSON 格式。authorization：調用 API 的密鑰，申請之後可以直接下拉選擇。
model：生成視頻的模型。- Seedance 1.x 系列：
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。 - Seedance 2.0 系列（支持人臉 / 角色參考等多模態輸入）：
doubao-seedance-2-0-260128（標準）、doubao-seedance-2-0-fast-260128（快速）、doubao-seedance-2-0-mini-260615（輕量）。詳見下文「人臉與角色參考（Seedance 2.0）」一節。
- Seedance 1.x 系列：
content：輸入內容數組，type可以是text（提示詞）、image_url（參考圖片）、audio_url（參考音頻，2.0）、video_url（參考視頻，2.0）。圖片可通過role指定用途：first_frame（首幀）/last_frame（尾幀）/reference_image（人臉 / 角色 / 主體參考）。resolution：輸出分辨率，可選480p/720p/1080p（2.0 標準模型另支持4k；2.0 的fast/mini最高720p）。ratio：寬高比，可選16:9/4:3/1:1/3:4/9:16/21:9/adaptive。duration：視頻時長（秒，整數）。各系列範圍不同：1.0 系列 2–12；1.5 Pro 4–12；2.0 系列 4–15。1.5 Pro 與 2.0 系列另支持-1（由模型自動選擇時長）。seed：隨機種子，整數，-1 到 4294967295。camerafixed：是否固定攝像頭，true/false。watermark：是否添加水印，true/false。generate_audio：是否生成有聲視頻，true/false，僅doubao-seedance-1-5-pro-251215支持。return_last_frame：是否在結果中返回視頻最後一幀圖片 URL。execution_expires_after：任務超時時間（秒），範圍 3600–259200。callback_url：異步回調地址，設置後 API 立即返回task_id，任務完成時將結果 POST 到該地址。async：可選，設為true時接口立即返回task_id，無需提供callback_url，隨後通過對應的任務查詢接口輪詢獲取結果。
success，此時視頻生成任務的狀態情況。task_id，此時視頻生成任務ID。trace_id，此時視頻生成跟蹤ID。data，此時視頻生成任務的結果列表。task_id，此時視頻生成任務的伺服器端ID。video_url，此時視頻生成任務的視頻鏈接。status，此時視頻生成任務的狀態。model，生成視頻使用的模型。
data 的視頻鏈接地址獲取生成的SeeDance視頻即可。
另外如果想生成對應的對接代碼，可以直接複製生成，例如 CURL 的代碼如下：
內聯參數說明
在content[].text 提示詞末尾，可以通過追加 --parameter value 的形式傳入生成參數（舊方式，弱校驗，填寫有誤時自動使用默認值）。完整參數列表如下：
推荐做法：直接在 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 2.0）
Seedance 2.0 系列（doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615）支持传入「真人 / 角色」的参考素材：在 content 中加入 type 为 image_url、role 为 reference_image 的项，把人物照片作为参考，模型会在生成的视频里保持该人物的样貌特征，从而把同一个人「放进」全新的场景、动作或镜头里。
📌 真人照片会被平台自动注册为底层素材后再用于生成，整个过程对调用方完全透明：请求与响应格式不变，无需任何额外参数，仅首次生成会多花几秒用于素材处理。使用要点：
- 仅 Seedance 2.0 系列模型支持
reference_image；1.x 模型请使用first_frame/last_frame（图生视频首尾帧）。 reference_image不能与first_frame/last_frame混用，二者只能择一。- 多模态参考数量上限：
image_url最多 9 张；2.0 还支持audio_url（role为reference_audio，最多 3 条）与video_url（role为reference_video，最多 3 条）。 - 参考音频（
audio_url）素材要求：格式wav/mp3；单条时长 2~15 秒，最多 3 条且总时长不超过 15 秒；单条不超过 15 MB。超出时长范围会在素材处理阶段失败。 - 参考视频（
video_url）素材要求：格式mp4/mov；单条时长 2~15 秒，最多 3 条且总时长不超过 15 秒。 - 参考图片建议使用单人、正脸、清晰、无遮挡的照片，人脸越清晰，相似度越高。
示例一：保持人物样貌的特写
传入一张人脸照片，让该人物对着镜头微笑挥手。对应的代码：示例二：把同一个人放进全新场景
reference_image 的强大之处在于：只保留人物身份，而场景、服装、动作完全由提示词决定。下面用同一张人脸照片，让该人物身着米色大衣走在秋日公园里：
💡 若想让人物精确复刻照片中的构图（而非「换个场景的同一个人」），可改用 first_frame（图生视频首帧），让视频从这张照片开始运动。
异步回调
由于 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：内部服务器错误，服务器出现问题。