使用 Seedance 视频生成 API
视频生成通过统一接口创建任务并查询结果;文本、图片、首尾帧和参考视频等输入类型会影响请求参数、模型选择与计费。
确定输入场景
纯提示词对应文生视频;首尾帧需要至少两张图片;参考图或参考视频则需要对应的公开可访问素材。input_type 可以显式指定,也可在部分场景由素材自动推断。
不要把分辨率、时长和音频支持视为所有模型的共同能力。应先核对所选模型的支持范围,再发送生产任务。
创建并轮询任务
提交时包含 model、prompt,以及与场景匹配的 images、videos、audios、resolution、ratio 和 duration。响应中的任务标识用于后续查询;应用侧应使用退避轮询或回调机制,避免高频重复请求。
POST /v1/videos/generations
Authorization: Bearer sk-your-key
Content-Type: application/json
{
"model": "your-enabled-video-model",
"prompt": "镜头平滑推进,角色从静止到转身",
"input_type": "text_to_video",
"resolution": "720p",
"duration": 5
}
处理异步结果
视频任务不是即时聊天响应。保存任务 ID、请求参数和调用方关联信息,查询完成状态后再消费最终资源。对于超时、失败或素材不可访问等情况,应向用户展示可操作的错误信息。