视频生成

POST

api

contents

generations

tasks

A valid request URL is required to generate request examples

{
  "id": "task_01JXYZEXAMPLE"
}

{
  "code": "invalid_request",
  "message": "request validation failed"
}

{
  "code": "unauthorized",
  "message": "invalid API key"
}

{
  "code": "rate_limit_exceeded",
  "message": "too many requests"
}

{
  "code": "internal_error",
  "message": "model service unavailable"
}

model 没有固定值，请填写模型列表返回的实际模型 ID。

参考素材必须是模型服务可以访问的公网 URL。你可以使用下方的平台上传流程获取 public_url，也可以直接填写自己已有的公网 URL；本接口不接收本地路径、Base64、文件二进制或预签名上传地址。

创建成功后保存任务 ID，并使用获取任务状态轮询结果。

支持的生成方式

方式	`content` 组合	素材角色
文生视频	`text`	无
首帧生视频	`text` + 1 个 `image_url`	`first_frame` 或省略
首尾帧生视频	`text` + 2 个 `image_url`	`first_frame`、`last_frame`
多模态参考	`text` + 图片、视频、音频	`reference_image`、`reference_video`、`reference_audio`
样片生成正式视频	`draft_task`	提供样片任务 ID

首尾帧模式与多模态参考模式互斥。参考音频不可单独输入，至少同时提供一张参考图片或一个参考视频。具体素材数量、时长、分辨率和模型能力以当前模型为准。

参考素材的两种方式

方式一：使用平台上传流程

适合素材只保存在本地，或希望由平台统一管理文件的场景。完成上传后，将响应中的 public_url 填入请求体：

获取上传地址

调用 POST /v1/upload/presign，提交文件名和 MIME 类型。

上传文件

使用返回的 url、method 和 headers 完成 PUT 上传。

调用视频模型

将返回的 public_url 放入 image_url.url、video_url.url 或 audio_url.url。

方式二：直接提供公网 URL

如果素材已经部署在可公开访问的对象存储或 CDN，可跳过上传接口，直接将 URL 放入对应字段：

{
  "type": "image_url",
  "image_url": { "url": "https://cdn.example.com/reference/first-frame.png" },
  "role": "first_frame"
}

URL 必须无需登录、无需 Cookie 或临时签名即可从公网访问，并返回正确的媒体内容类型。请确认 URL 在任务执行期间持续有效，且模型服务所在网络能够访问；浏览器能打开不代表模型服务一定能访问。

任务与结果

任务可能依次进入 queued、running、succeeded、failed、cancelled 或 expired。建议每 2-5 秒查询一次。生成视频和尾帧地址可能具有有效期，请及时转存。

授权

Authorization

string

header

必填

请求头格式：Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

string

必填

账户实际可用的模型 ID。该值不固定，请从 GET /v1/models 获取。

Minimum string length: 1

content

object[]

必填

输入内容。支持文本，以及使用上传接口 public_url 或已有公网 URL 的图片、视频、音频素材；也可按目标模型能力使用样片任务。

Minimum array length: 1

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

callback_url

string<uri>

任务状态变化时接收 POST 回调的公网地址。回调内容与查询任务响应一致。

return_last_frame

boolean

默认值:false

是否在任务结果中返回 last_frame_url，适合连续视频生成。

service_tier

enum<string>

默认值:default

default 为在线推理；flex 为离线推理。目标模型可能只支持其中一种。

可用选项:

default,

flex

execution_expires_after

integer

默认值:172800

任务超时阈值，单位秒。

必填范围: 3600 <= x <= 259200

generate_audio

boolean

默认值:true

是否生成与画面同步的音频，仅部分模型支持。

draft

boolean

默认值:false

是否生成低成本样片，仅部分模型支持。样片模式通常限定为 480p。

resolution

enum<string>

默认值:720p

视频分辨率。可用值由目标模型决定。

可用选项:

480p,

720p,

1080p,

4k

ratio

enum<string>

默认值:16:9

视频宽高比。adaptive 表示由模型根据提示词和参考素材选择。

可用选项:

16:9,

4:3,

1:1,

3:4,

9:16,

21:9,

adaptive

duration

integer

默认值:5

视频时长，单位秒。-1 表示由支持该能力的模型智能选择；不同模型常见范围为 2-15 秒。与 frames 二选一，frames 优先。

必填范围: -1 <= x <= 15

frames

integer

视频帧数。仅支持 25 + 4n 格式的整数；与 duration 二选一且优先级更高。部分模型不支持。

必填范围: 29 <= x <= 289

seed

integer

默认值:-1

随机种子。-1 表示随机；目标模型可能不支持。

必填范围: -1 <= x <= 4294967295

camera_fixed

boolean

默认值:false

是否固定摄像头。参考图场景或部分模型可能不支持。

watermark

boolean

默认值:false

是否在生成视频右下角展示 AI 生成水印。

safety_identifier

string

终端用户唯一标识符，用于请求追踪。

priority

integer

任务执行优先级，是否支持由服务配置决定。

tools

object[]

任务可使用的扩展工具。

Show child attributes

响应

任务创建成功

string

必填

视频生成任务 ID。任务记录通常保存 7 天。

A valid request URL is required to generate request examples

{
  "id": "task_01JXYZEXAMPLE"
}

{
  "code": "invalid_request",
  "message": "request validation failed"
}

{
  "code": "unauthorized",
  "message": "invalid API key"
}

{
  "code": "rate_limit_exceeded",
  "message": "too many requests"
}

{
  "code": "internal_error",
  "message": "model service unavailable"
}

概览

模型

文字系列

图像系列

视频系列

音频系列

上传管理

支持的生成方式

参考素材的两种方式

方式一：使用平台上传流程

方式二：直接提供公网 URL

任务与结果

授权

请求体

响应

​支持的生成方式

​参考素材的两种方式

​方式一：使用平台上传流程

​方式二：直接提供公网 URL

​任务与结果

授权

请求体

响应

支持的生成方式

参考素材的两种方式

方式一：使用平台上传流程

方式二：直接提供公网 URL

任务与结果