Seedance 视频生成 API：文生、图生、首尾帧、真人参考，一个接口都能做
内容提要
Seedance是字节豆包系的视频生成模型，支持文生视频、图生视频、首尾帧及真人参考。通过Ace Data Cloud的API接口调用，需获取Token，首次有免费额度。支持异步任务，可轮询获取结果。2.0/2.5版本支持多模态参考和视频编辑，参数包括分辨率、比例、时长等。适用于短视频、电商展示和有声短片制作，真人参考功能尤其适合批量内容创作。
延伸解读
接口结构差异与参数陷阱
Seedance 的输入结构与其他视频接口不同，提示词、参考图、音视频都放在 content 数组里，用 type 区分。注意 image_url 必须是对象格式，不能直接传字符串，否则会报 400。首帧、首尾帧和全模态参考三种场景互斥，不能混用 first_frame 和 reference_image 等参数。调用前需仔细核对参数格式，避免因细节错误导致请求失败。
异步任务与成本控制
视频生成耗时 1-2 分钟，接口支持 async 异步模式，提交后立即返回 task_id，再通过轮询或 callback_url 获取结果。平台按量计费，示例中一条 5 秒 720p 视频消耗 5.7 credits。建议先用免费额度测试，了解不同参数（如分辨率、时长）对成本的影响，再批量生产，避免不必要的费用。
真人参考的合规与适用边界
真人参考功能可让同一个人出现在全新场景，适合批量内容创作，但需注意仅上传自有或已获授权的素材。若需精确复刻照片构图，应使用首帧模式而非参考图模式。该功能虽强大，但存在版权和肖像权风险，使用时务必确保素材合法性，并明确区分不同模式的应用场景。
Q&A
Seedance 视频生成 API 支持哪些输入方式？
Seedance 视频生成 API 支持文生视频、图生视频（首帧/首尾帧）、真人参考（角色参考）以及多模态参考（图片、视频、音频），还支持视频编辑和延长。
如何调用 Seedance 视频生成 API？
首先在 Ace Data Cloud 控制台获取 Token，然后向接口 POST https://api.acedata.cloud/seedance/videos 发送请求，请求头需包含 authorization: Bearer {token}。首次申请有免费额度。
Seedance 视频生成 API 的异步任务如何获取结果？
在请求中设置 async: true，会立即返回 task_id。然后向 /seedance/tasks 接口轮询，携带 task_id 和 action: retrieve，当 data.status 为 succeeded 时，data.video_url 即为生成的视频链接。
Seedance 支持哪些分辨率和视频比例？
分辨率支持 480p、720p、1080p，2.0 Standard 还支持 4k。视频比例支持 16:9、9:16、1:1、4:3、3:4、21:9 以及 adaptive。
Seedance 2.5 版本相比 2.0 有哪些增强？
Seedance 2.5 支持最多 30 张参考图、10 段视频、10 段音频，支持纯音频参考，并能对参考视频进行编辑或延长。此外，2.5 的 omni_reference_task_type 可设为 auto、reference、edit 或 extend。
Seedance 视频生成 API 有哪些实际应用场景？
适用于竖屏短视频（适配抖音/小红书）、电商产品展示（首帧或首尾帧）、有声短片制作（配合 generate_audio）。真人参考功能尤其适合批量生成固定出镜人设的内容。
Seedance 视频生成 API 如何计费？
按量计费，以 credits 为单位。例如文中示例生成一条 5 秒 720p 视频实际消耗 5.7 credits。首次申请有免费额度。
Seedance 视频生成 API 支持哪些模型版本？
支持 1.x、1.5、2.0 以及 doubao-seedance-2-5-260628 等版本。不同版本在功能上有所差异，例如 2.0 支持多模态参考，2.5 支持更多参考素材和视频编辑。
