跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
使用 Seedance 1.0 Pro 将静态图片转为 5 秒或 10 秒的视频,用文本引导场景和运动。

模型

  • bytedance/seedance/v1/pro/image-to-video - 根据输入图片生成视频。

功能

  • 根据输入图片生成视频。
  • image_urls 中只接受恰好 1 张图片。
  • 输出分辨率可选 720p、1080p。

时长选项

  • 5、10 秒 - 将 duration 设为数值整数。可选。仅在省略时默认为 5 秒。字符串、布尔值、null 和小数会被拒绝。5.0 这样的数值等同于 5。

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流参数(包括输出选项)都放在 input 中。 只传本工作流支持的 input 字段。不支持的 input 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)、包含主机名,且不能内嵌凭证或包含空白。默认值仅在省略可选 input 字段时生效;显式传入 null 或空值会被拒绝。

提示词

  • prompt:必填字符串。描述场景和期望的运动。去除首尾空白后,长度必须为 1-10,000 个 Unicode 字符。非字符串值会被拒绝。
  • 传入时值不能为空白。

图片 URL

  • image_urls:必填。提供可公开访问的图片 URL。恰好传 1 项,每项必须是 HTTP(S) URL。Base64、用裸字符串代替数组以及空数组都会被拒绝。

分辨率

  • resolution:可选。可选值:720p、1080p。仅在省略时默认为 720p。别名、大小写不同、带首尾空白或数值形式的值都会被拒绝。

计费因素

计费取决于输出分辨率(resolution)和视频时长(duration)。文生视频和图生视频使用相同费率。 积分在提交时扣除,任务失败时退还。

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和可选的 callback_url 放在根级。不支持的 input 字段会被拒绝。默认值仅对省略的字段生效;null 和空的 input 值会被拒绝。

model
string
必填
示例:

"bytedance/seedance/v1/pro/image-to-video"

input
object
必填

生成所需的输入参数

callback_url
string | null

可选,接收任务完成通知的公开 HTTP(S) 地址,建议使用 HTTPS。省略、传 null 或传空字符串即不启用回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填