1. 视频生成（Videos）
AI接口文档
  • 图片生成（Images）
    • 香蕉（异步）
      POST
    • image2（同步）
      POST
    • gpt-image-2（异步）
      POST
    • 任务查询
      GET
  • 视频生成（Videos）
    • Omni创建
      POST
    • veo创建
      POST
    • Grok创建
      POST
    • Seedance创建
      POST
    • MiniMax创建
      POST
    • 任务查询
      GET
  • 失效接口
    • sora创建
      POST
    • veo（直出15s）
      POST
    • Veo （延长至15s）
      POST
  1. 视频生成（Videos）

Seedance创建

开发中
POST
/v1/videos

Seedance 视频生成接口文档#

接口地址#

POST /v1/videos

功能说明#

支持 Seedance 系列模型的文生视频和图片参考生成；Seedance 2.0 系列额外支持视频、音频组合参考。

当前模型#

模型名支持模式视频/音频参考时长seconds 取值
seedance-2.0文生、首帧/首尾帧、参考内容支持4～15 秒"4"～"15"
seedance-2.0-mini文生、首帧/首尾帧、参考内容支持4～15 秒"4"～"15"
seedance-2.5-10s文生、首帧/首尾帧、图片参考不支持固定 10 秒"10"
seedance-2.5-15s文生、首帧/首尾帧、图片参考不支持固定 15 秒"15"
seedance-2.5-30s文生、首帧/首尾帧、图片参考不支持固定 30 秒"30"
Seedance 2.0 系列通过 seconds 自由选择 4～15 秒，并支持图片、视频、音频参考。Seedance 2.5 系列的时长由模型名固定，只支持图片参考，不支持视频或音频参考。

支持的参考内容#

图片：通过 images 数组传递。
视频：仅 seedance-2.0、seedance-2.0-mini 支持，通过 videos 数组传递。
音频：仅 seedance-2.0、seedance-2.0-mini 支持，通过 audios 数组传递。
Seedance 2.0 系列可组合使用图片 + 视频、图片 + 音频、视频 + 音频，或图片 + 视频 + 音频。
seedance-2.5-10s、seedance-2.5-15s、seedance-2.5-30s 不得传 videos 或 audios。

模式判定#

模式传参方式
文生视频不传 images、videos、audios，或全部传空数组
首帧images 传 1 张图，first_last_frame: true
首尾帧images 依次传首帧、尾帧，first_last_frame: true
参考模式传参考素材，不传 first_last_frame 或传 false
参考模式下，素材的具体用途应在 prompt 中明确，例如“图片 1 是产品外观”“视频 1 作为运镜参考”“音频 1 作为背景音乐”。

请求方式#

方式Content-Type参考素材字段
JSONapplication/jsonimages、videos、audios
表单multipart/form-data只使用可重复的 input_reference
表单没有 video_reference 或 audio_reference 字段。图片、视频、音频文件或 URL 均通过重复的 input_reference 传递。

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是application/json 或 multipart/form-data

JSON 请求体说明#

参数名类型必填说明
modelstring是Seedance 模型名称
promptstring是视频生成提示词；组合参考时应说明每项素材的用途
imagesstring[]否图片 URL 或完整 Base64 data URI
videosstring[]否可公网访问的视频文件直链；仅 Seedance 2.0 系列支持
audiosstring[]否可公网访问的音频文件直链；仅 Seedance 2.0 系列支持
aspect_ratiostring否支持 16:9、9:16、1:1、4:3、3:4、21:9
resolutionstring否输出分辨率；使用模型默认值时可不传，可用值以服务端配置为准
secondsstring是Seedance 2.0 系列支持 "4"～"15"；2.5 固定时长模型必须传与模型名一致的 "10"、"15" 或 "30"
first_last_frameboolean否true 为首帧/首尾帧模式；不传或 false 为参考模式

Seedance 2.0 组合参考素材 JSON 结构#

{
  "images": [
    "https://example.com/ref.png"
  ],
  "videos": [
    "https://example.com/ref.mp4"
  ],
  "audios": [
    "https://example.com/ref.mp3"
  ]
}
数组元素必须是实际的文件直链。不要写成 Markdown 链接：
错误：[https://example.com/ref.png](https://example.com/ref.png)
正确：https://example.com/ref.png

素材数量约定#

首帧/首尾帧：images 传 1～2 张图片。
纯参考图：建议传 1～4 张图片。
Seedance 2.0 组合参考内容：图片、视频、音频合计最多 9 项。
Seedance 2.5 固定时长模型：只可传图片，不得传视频或音频。
多项素材按各自数组中的顺序编号为图片 1、视频 1、音频 1 等。

表单字段说明#

参数名类型必填说明
modelstring是Seedance 模型名称
promptstring是视频生成提示词
input_reference可重复字段否图片、视频、音频的本地文件、URL 或受支持的 Base64；每项重复传一次。Seedance 2.5 固定时长模型只允许图片
aspect_ratiostring否视频宽高比
resolutionstring否输出分辨率，可用值以服务端配置为准
secondsstring是2.0 系列支持 4～15；2.5 系列必须与模型名中的固定秒数一致
first_last_frameboolean/string否true 为首帧/首尾帧；不传或 false 为参考模式

Seedance 2.0 input_reference 组合参考示例#

请求示例#

文生视频（JSON）#

首帧视频（JSON）#

首尾帧视频（JSON）#

多参考图（JSON）#

图片、视频和音频组合参考（JSON）#

本地组合参考文件（表单，仅使用 input_reference）#

响应参数#

完成态视频地址位于顶层 url 和 video_url，两者值相同。
参数名类型说明
idstring任务 ID
objectstring固定值 video
modelstring实际使用的模型名称
statusstringqueued、in_progress、completed、failed
progressnumber任务进度，0～100
created_atnumber创建时间戳（秒）
completed_atnumber完成时间戳（秒，仅完成态）
urlstring视频直链（仅完成态）
video_urlstring与 url 同值（仅完成态）
errorobject失败信息，通常包含 code、message

提交成功#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-15s",
  "status": "queued",
  "progress": 0,
  "created_at": 1791320000
}

任务完成#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-15s",
  "status": "completed",
  "progress": 100,
  "created_at": 1791320000,
  "completed_at": 1791320060,
  "url": "https://example.com/output.mp4",
  "video_url": "https://example.com/output.mp4"
}

任务失败#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-15s",
  "status": "failed",
  "progress": 0,
  "created_at": 1791320000,
  "error": {
    "code": "invalid_request",
    "message": "请求参数不符合模型能力限制"
  }
}

查询任务状态#

GET /v1/videos/{task_id}
queued / in_progress 时继续轮询；completed 时读取顶层 url 或 video_url；failed 时读取 error.message。

注意事项#

1.
seconds 必须使用字符串。seedance-2.0、seedance-2.0-mini 支持 "4"～"15"；seedance-2.5-10s、seedance-2.5-15s、seedance-2.5-30s 分别只能使用 "10"、"15"、"30"。
2.
首尾帧模式下，images[0] 是首帧，images[1] 是尾帧；只有 1 张时表示仅指定首帧。
3.
参考模式不传 first_last_frame 或传 false。建议在提示词中明确每个参考素材的用途。
4.
JSON 图片使用 images；Seedance 2.0 系列的视频、音频分别使用 videos、audios。表单只有可重复的 input_reference。
5.
JSON 数组中只能填写文件直链或受支持的 data URI，不能填写 Markdown 链接表达式。
6.
Seedance 2.0 系列组合参考素材合计最多 9 项；Seedance 2.5 固定时长模型只支持图片参考。文件越多、越大，提交和处理时间越长。
7.
所有 URL 都必须是无需登录、可直接返回文件内容的公网直链。
8.
接口为异步接口，提交成功后需轮询任务状态。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "model": "seedance-2.0",
    "prompt": "使用图片 1 的产品；参考视频 1 的第一视角运镜；全程使用音频 1 作为背景音乐",
    "images": [
      "https://example.com/ref.png"
    ],
    "videos": [
      "https://example.com/ref.mp4"
    ],
    "audios": [
      "https://example.com/ref.mp3"
    ],
    "aspect_ratio": "16:9",
    "seconds": "11"
  }

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "seedance-2.0",
    "prompt": "使用图片 1 的产品；参考视频 1 的第一视角运镜；全程使用音频 1 作为背景音乐",
    "images": [
      "https://example.com/ref.png"
    ],
    "videos": [
      "https://example.com/ref.mp4"
    ],
    "audios": [
      "https://example.com/ref.mp3"
    ],
    "aspect_ratio": "16:9",
    "seconds": "11"
  }'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "size": "1920x1080"
}
修改于 2026-10-07 13:36:05
上一页
Grok创建
下一页
MiniMax创建
Built with