Skip to main content
POST

Seedance 1.5

Seedance 1.5 使用 multipart/form-data 请求提交异步视频任务。模型名中的 480p720p1080p 表示输出清晰度档位。
  • 接口路径是 POST /v1/videos
  • 请求格式是 multipart/form-data
  • 可用模型为 doubao-seedance-1-5-pro_480pdoubao-seedance-1-5-pro_720pdoubao-seedance-1-5-pro_1080p
  • seconds 支持 411 秒。
  • size 传宽高比,例如 16:99:161:14:33:421:9
  • 首帧图使用 first_frame_image,尾帧图使用 last_frame_image,字段值传服务端可访问的图片 URL。

方法与路径

请求示例

响应示例

认证

使用 Bearer Token 鉴权:

Form Fields

model
string
required
模型名称。可选 doubao-seedance-1-5-pro_480pdoubao-seedance-1-5-pro_720pdoubao-seedance-1-5-pro_1080p
prompt
string
required
视频生成提示词。
seconds
string
视频时长。支持 411 秒,建议按字符串传入,例如 "8"
size
string
宽高比。常用值包括 16:99:161:14:33:421:9keep_ratioadaptive
first_frame_image
string
首帧图片 URL。用于首帧生视频或首尾帧模式,需传服务端可访问的公网 URL。
last_frame_image
string
尾帧图片 URL。通常与 first_frame_image 一起用于首尾帧模式,需传服务端可访问的公网 URL。

Response

id
string
视频任务 ID。后续可用于 GET /v1/videos/{id} 查询。
task_id
string
视频任务 ID 的兼容字段。通常与 id 相同。
object
string
对象类型,通常为 video
model
string
本次任务使用的模型,例如 doubao-seedance-1-5-pro_720p
status
string
任务状态。常见值为 queuedin_progresscompletedfailed
progress
number
任务进度,常见范围为 0100
video_url
string
任务完成后的视频地址。也可以使用 GET /v1/videos/{id}/content 下载结果。
error
object
任务失败或接口错误时返回的错误对象,通常包含 messagecode

模型选择

使用场景

720p 文生视频

竖屏首帧生视频

首尾帧过渡

注意事项

  • 请求格式为 multipart/form-data
  • 图片通过 first_frame_imagelast_frame_image 传入 URL;本地文件需先上传到服务端可访问的公网地址。
  • seconds 支持 411 秒。
  • 模型名里的 480p720p1080p 决定输出清晰度。
  • 不推荐用于“参考生视频”模式;需要图片约束时优先使用首帧或首尾帧。

相关接口