火山方舟视频生成 API 文档

即梦视频生成

即梦视频生成 3.0 Pro 具备多镜头叙事能力，能更精准遵循指令，动态表现流畅自然，支持生成1080P 高清且具专业级质感的视频。

支持功能：

文生视频：输入文本提示词，生成视频；
图生视频-首帧：输入首帧图片和文本提示词，生成视频。

支持的模型

模型名称	类型	说明
`即梦视频生成 3.0 Pro`	文生视频 / 图生视频	即梦视频 3.0 Pro，支持文生视频与图生视频（首帧）

统一请求地址

操作	请求方法	请求地址
创建任务	POST	`{base_url}/videos`
查询任务	GET	`{base_url}/videos/{task_id}`

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Bearer	鉴权信息

创建任务

请求体参数

参数名	类型	必填	说明	取值范围/格式
`model`	string	是	模型名称	`即梦视频生成 3.0 Pro` 等（以配置为准）
`prompt`	string	文生视频必填	文本提示词，描述要生成的视频内容	建议 400 字以内，不超过 800 字
`img_url`	string	图生视频必填*	首帧图片 URL	有效可访问的图片 URL
`image_url`	string	图生视频必填*	同 `img_url`，二选一	有效可访问的图片 URL
`binary_data_base64`	string / array	图生视频必填*	首帧图片 Base64 编码	与 `img_url`/`image_url` 二选一
`seconds`	integer	否	视频时长（秒）	`5`、`10`，默认 5
`duration`	integer	否	同 `seconds`，二选一	`5`、`10`
`frames`	integer	否	总帧数，直接传入时优先于 seconds	`121`（5s）、`241`（10s）
`aspect_ratio`	string	否	视频宽高比（文生视频生效）	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`，默认 `16:9`
`size`	string	否	视频尺寸，会转换为 `aspect_ratio`	如 `1920*1080`、`1920x1080`
`seed`	integer	否	随机种子，相同值可复现效果	默认 -1（随机）
`provider`	object	否	服务商偏好，如指定 `{"sort": ["火山方舟"]}`	可选

* 图生视频：prompt 与图片（img_url / image_url / binary_data_base64）二选一必填。

图片要求（图生视频）

要求	说明
格式	JPEG、PNG
数量	仅 1 张
大小	最大 4.7MB
分辨率	最大 4096×4096，最短边 ≥ 320
宽高比	长边/短边 ≤ 3

建议图片宽高比接近 aspect_ratio 可选取值，避免裁剪影响效果。

aspect_ratio 与生成尺寸

宽高比	生成尺寸
16:9	1920×1088
4:3	1664×1248
1:1	1440×1440
3:4	1248×1664
9:16	1088×1920
21:9	2176×928

请求示例

1. 文生视频

json

{
  "model": "即梦视频生成 3.0 Pro",
  "prompt": "千军万马，草原上骑兵奔腾",
  "aspect_ratio": "16:9",
  "seconds": 5
}

2. 图生视频（图片 URL）

json

{
  "model": "即梦视频生成 3.0 Pro",
  "prompt": "画面中的人物开始行走",
  "img_url": "https://example.com/first-frame.jpg",
  "seconds": 5
}

3. 图生视频（Base64）

json

{
  "model": "即梦视频生成 3.0 Pro",
  "prompt": "画面中的人物开始行走",
  "binary_data_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB...",
  "seconds": 10
}

响应格式

创建任务响应（POST /videos）

json

{
  "id": "7392616336519610409_abc123",
  "status": "queued",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "model": "即梦视频生成 3.0 Pro",
  "seconds": 5,
  "size": "1920*1088"
}

字段	类型	说明
`id`	string	任务 ID，用于 GET /videos/{taskid} 查询；格式为 `{原始任务ID}{模型ID}`
`status`	string	初始为 `queued`，表示已提交排队
`created_at`	string	任务创建时间（ISO 8601）
`model`	string	模型名称
`seconds`	integer	视频时长（秒）
`size`	string	视频尺寸（如 1920*1088）

任务结果需通过 GET /videos/{task_id} 轮询获取。

查询任务

网络协议	请求地址	请求方法	响应格式
https	`{base_url}/videos/{task_id}`	GET	application/json

请求路径参数

参数名	类型	必填	说明
`task_id`	string	是	创建任务时返回的 `id`

Query 参数（可选）

参数名	类型	必填	说明
`provider`	string	否	服务商名称（如 `火山方舟`）。任务不在本地缓存时指定可加快查询

响应体（任务进行中）

json

{
  "id": "7392616336519610409_abc123",
  "status": "in_progress",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "model": "即梦视频生成 3.0 Pro"
}

响应体（任务完成）

json

{
  "id": "7392616336519610409_abc123",
  "status": "completed",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "completed_at": "2025-02-12T10:03:00.000000Z",
  "model": "即梦视频生成 3.0 Pro",
  "video_url": "https://xxx/video.mp4",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "1920*1088"
  },
  "raw_response": { ... }
}

响应体（任务失败）

json

{
  "id": "7392616336519610409_abc123",
  "status": "failed",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "model": "即梦视频生成 3.0 Pro",
  "error": "内容审核未通过"
}

响应字段说明

字段	类型	说明
`id`	string	任务 ID
`status`	string	任务状态：`queued`、`in_progress`、`completed`、`failed`
`created_at`	string	任务创建时间
`completed_at`	string	任务完成时间（仅完成时返回）
`model`	string	模型名称
`video_url`	string	生成的视频 URL（仅完成时返回，有效期 1 小时）
`usage.seconds`	float	视频时长（秒）
`usage.video_count`	int	生成的视频数量
`usage.size`	string	视频尺寸
`raw_response`	object	火山引擎原始响应（可选）
`error`	string	错误信息（仅失败时返回）

任务状态

状态	说明
`queued`	任务排队中
`in_progress`	任务处理中
`completed`	任务完成
`failed`	任务失败

注意事项

异步任务：创建任务后返回 id，需轮询 GET /videos/{task_id} 获取结果。
视频有效期：video_url 有效期为 1 小时，请及时下载或转存。
任务过期：任务过期时间为 12 小时，超时需重新创建。
prompt 长度：建议 400 字以内，不超过 800 字。

底层接入火山引擎即梦视频 API，官方文档可参考：
火山引擎视觉智能即梦视频
通用返回字段及错误码

Doubao-Seedance-1.0-Pro-Fast

接口简介

Doubao-Seedance-1.0-Pro-Fast 为火山方舟视频生成模型，通过创建视频生成任务接口提交任务，生成完成后通过查询任务接口获取视频。模型依据传入的图片及文本信息生成视频。

Seedance 1.0 Pro Fast 支持能力：

图生视频-首帧：首帧图片 + 文本提示词（可选）+ 参数（可选）生成视频；
文生视频：文本提示词 + 参数（可选）生成视频。

创建视频生成任务

操作	请求方法	请求地址
创建任务	POST	`{base_url}/videos`

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Bearer	鉴权信息

请求体参数

参数名	类型	必填	说明	备注
`model`	string	是	模型名称	固定为 `Doubao-Seedance-1.0-Pro-Fast`
`prompt`	string	文生视频必填	文本提示词，描述要生成的视频内容	建议中文 ≤500 字，英文 ≤1000 词
`img_url`	string	图生视频必填*	首帧图片 URL	与 `image_url` / `binary_data_base64` 二选一
`image_url`	string	图生视频必填*	同 `img_url`	与 `img_url` / `binary_data_base64` 二选一
`binary_data_base64`	string	图生视频必填*	首帧图片 Base64 编码	与 `img_url` / `image_url` 二选一
`seconds`	integer	否	视频时长（秒）	默认 5，支持 2~12；与 `frames` 二选一
`duration`	integer	否	同 `seconds`，二选一	同上
`frames`	integer	否	视频帧数	与 `seconds`/`duration` 二选一，frames 优先；取值需满足 25+4n，范围 [29, 289]；Seedance 1.5 pro 暂不支持
`resolution`	string	否	视频分辨率	Seedance 1.0 pro / pro-fast 默认 `1080p`，可选 `480p`、`720p`、`1080p`
`ratio`	string	否	宽高比，文生视频默认 `16:9`，图生视频默认 `adaptive`	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`
`aspect_ratio`	string	否	同 `ratio`，二选一	同上
`seed`	integer	否	随机种子	默认 -1，范围 [-1, 2^32-1]
`camera_fixed`	boolean	否	是否固定摄像头	默认 `false`；参考图场景不支持
`watermark`	boolean	否	是否带水印	默认 `false`
`callback_url`	string	否	任务状态变化时的回调通知地址	方舟将向此地址推送 POST 请求；回调 status：queued、running、succeeded、failed、expired
`return_last_frame`	boolean	否	是否返回生成视频的尾帧图像	默认 `false`；为 true 时可通过查询任务接口获取尾帧，用于连续多段视频
`service_tier`	string	否	服务等级	默认 `default`；`default` 在线推理，`flex` 离线推理（价格约 50%，TPD 更高）
`execution_expires_after`	integer	否	任务超时时间（秒），从任务创建时间起算	默认 172800（48 小时），范围 [3600, 259200]；超时后任务标记为 expired
`generate_audio`	boolean	否	是否生成与画面同步的音频	仅 Seedance 1.5 pro 支持；1.0 Pro Fast 不支持
`draft`	boolean	否	是否开启样片模式（预览视频）	仅 Seedance 1.5 pro 支持；1.0 Pro Fast 不支持；样片模式使用 480p，不支持尾帧与离线推理

* 图生视频：prompt 与图片（img_url / image_url / binary_data_base64）二选一必填。

图片要求（与即梦章节一致）：格式 jpeg、png、webp 等；宽高比 (0.4, 2.5)，宽高 (300, 6000) px，大小 < 30 MB。

分辨率与宽高比（Seedance 1.0 系列）

分辨率	宽高比	宽高像素值（示例）
480p	16:9	864×480
480p	4:3	736×544
480p	1:1	640×640
720p	16:9	1248×704
720p	4:3	1120×832
720p	1:1	960×960
1080p	16:9	1920×1088
1080p	4:3	1664×1248
1080p	1:1	1440×1440

更多组合见输出视频格式。图生视频时，若所选宽高比与首帧图不一致，将按图片裁剪规则居中裁剪。

请求示例

1. 文生视频

json

{
  "model": "Doubao-Seedance-1.0-Pro-Fast",
  "prompt": "花瓣掉落下来",
  "seconds": 2,
  "resolution": "720p",
  "ratio": "16:9"
}

2. 图生视频-首帧（图片 URL）

json

{
  "model": "Doubao-Seedance-1.0-Pro-Fast",
  "prompt": "画面中的人物开始行走",
  "img_url": "https://example.com/first-frame.jpg",
  "seconds": 5,
  "resolution": "1080p",
  "ratio": "adaptive"
}

创建任务响应

返回 id、status、created_at、model 等；通过 GET {base_url}/videos/{task_id} 轮询获取 video_url。

查询视频生成任务

任务结果需通过 GET {base_url}/videos/{task_id} 轮询获取。

网络协议	请求地址	请求方法	响应格式
https	`{base_url}/videos/{task_id}`	GET	application/json

请求路径参数

参数名	类型	必填	说明
`task_id`	string	是	创建任务时返回的 `id`

Query 参数（可选）

参数名	类型	必填	说明
`provider`	string	否	服务商名称（如 `火山方舟`）。任务不在本地缓存时指定可加快查询

响应体（任务进行中）

json

{
  "id": "7392616336519610409_seedance_abc",
  "status": "in_progress",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "model": "Doubao-Seedance-1.0-Pro-Fast"
}

响应体（任务完成）

json

{
  "id": "7392616336519610409_seedance_abc",
  "status": "completed",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "completed_at": "2025-02-12T10:03:00.000000Z",
  "model": "Doubao-Seedance-1.0-Pro-Fast",
  "video_url": "https://xxx/video.mp4",
  "usage": {
    "seconds": 5.0,
    "video_count": 1,
    "size": "1920*1088"
  },
  "raw_response": { ... }
}

响应体（任务失败）

json

{
  "id": "7392616336519610409_seedance_abc",
  "status": "failed",
  "created_at": "2025-02-12T10:00:00.000000Z",
  "model": "Doubao-Seedance-1.0-Pro-Fast",
  "error": "内容审核未通过"
}

响应字段说明

字段	类型	说明
`id`	string	任务 ID
`status`	string	任务状态：`queued`、`in_progress`、`completed`、`failed`
`created_at`	string	任务创建时间
`completed_at`	string	任务完成时间（仅完成时返回）
`model`	string	模型名称
`video_url`	string	生成的视频 URL（仅完成时返回，请及时下载或转存）
`usage.seconds`	float	视频时长（秒）
`usage.video_count`	int	生成的视频数量
`usage.size`	string	视频尺寸
`raw_response`	object	火山引擎原始响应（可选）
`error`	string	错误信息（仅失败时返回）

任务状态

状态	说明
`queued`	任务排队中
`in_progress`	任务处理中
`completed`	任务完成
`failed`	任务失败

注意事项

仅首帧与文生：Seedance 1.0 Pro Fast 不支持首尾帧、参考图、样片（draft）、生成音频（generate_audio）等，这些能力属于 1.0 Pro / 1.5 Pro 等型号。
异步与轮询：创建任务后需用返回的 id 调用查询接口获取最终状态和 video_url。
任务与链接有效期：任务 ID 保留 7 天；生成的视频 URL 有效期以官方文档为准，请及时下载或转存。
提示词：建议参考 Seedance 提示词指南。

MiniMax

火山方舟 视频生成 API 文档 ​

即梦视频生成 ​

支持的模型 ​

统一请求地址 ​

请求头 ​

创建任务 ​

请求体参数 ​

图片要求（图生视频） ​

aspect_ratio 与生成尺寸 ​

请求示例 ​

1. 文生视频 ​

2. 图生视频（图片 URL） ​

3. 图生视频（Base64） ​

响应格式 ​

创建任务响应（POST /videos） ​

查询任务 ​

请求路径参数 ​

Query 参数（可选） ​

响应体（任务进行中） ​

响应体（任务完成） ​

响应体（任务失败） ​

响应字段说明 ​

任务状态 ​

注意事项 ​

Doubao-Seedance-1.0-Pro-Fast ​

接口简介 ​

创建视频生成任务 ​

请求头 ​

请求体参数 ​

分辨率与宽高比（Seedance 1.0 系列） ​

请求示例 ​

创建任务响应 ​

查询视频生成任务 ​

请求路径参数 ​

Query 参数（可选） ​

响应体（任务进行中） ​

响应体（任务完成） ​

响应体（任务失败） ​

响应字段说明 ​

任务状态 ​

注意事项 ​

火山方舟视频生成 API 文档

即梦视频生成

支持的模型

统一请求地址

请求头

创建任务

请求体参数

图片要求（图生视频）

aspect_ratio 与生成尺寸

请求示例

1. 文生视频

2. 图生视频（图片 URL）

3. 图生视频（Base64）

响应格式

创建任务响应（POST /videos）

查询任务

请求路径参数

Query 参数（可选）

响应体（任务进行中）

响应体（任务完成）

响应体（任务失败）

响应字段说明

任务状态

注意事项

Doubao-Seedance-1.0-Pro-Fast

接口简介

创建视频生成任务

请求头

请求体参数

分辨率与宽高比（Seedance 1.0 系列）

请求示例

创建任务响应

查询视频生成任务

请求路径参数

Query 参数（可选）

响应体（任务进行中）

响应体（任务完成）

响应体（任务失败）

响应字段说明

任务状态

注意事项