• Seedance API
  • 视频生成
  • 文生视频
  • 图生视频
  • 任务查询

使用 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、请求参数和调用方关联信息,查询完成状态后再消费最终资源。对于超时、失败或素材不可访问等情况,应向用户展示可操作的错误信息。

项目来源:docs/api/seedance-parameters.md、docs/api/video-generation.md、router/video-router.go

相关页面