生成视频
- 必须提供首帧,不支持纯文生视频
- 480p 与 720p 两档
- 可用 extend 续接已有视频
认证
所有接口均使用 Bearer Token 进行认证。获取 API Key:访问控制台 创建。请求时在请求头中添加:
All endpoints authenticate with a Bearer token. Create a key in the console and add it to the request header:
请求参数
视频类型,vid_1.1_i2v_480 或 vid_1.1_i2v_720。
首帧图片,公网 URL 或 Base64 data URI。
运动幅度,low 或 high。
视频描述。
尾帧图片,传了之后生成首尾帧过渡的视频。
是否循环,默认 false。
生成条数,取值 1、2、4,默认 4。
扩展视频时填 extend。
视频索引 0 到 3,action 不为空时必填。
父任务 ID,action 不为空时必填。
vid_1.1_i2v_480 or vid_1.1_i2v_720.
First-frame image as a public URL or Base64 data URI.
low or high.
Description of the video.
Last-frame image; supplying it produces a start-to-end transition.
Whether to loop; default false.
1, 2, or 4; default 4.
Set to extend to continue an existing video.
Video index 0 to 3; required with action.
Parent task ID; required with action.
分辨率与时长
videoType | 分辨率 | 用途 |
|---|---|---|
vid_1.1_i2v_480 | 480p | 草稿、预览 |
vid_1.1_i2v_720 | 720p | 成片交付 |
单段视频约 5 秒。需要更长时用 action: "extend" 在已有结果上续接。
videoType | Resolution | Use |
|---|---|---|
vid_1.1_i2v_480 | 480p | Drafts and previews |
vid_1.1_i2v_720 | 720p | Final delivery |
Each clip runs about 5 seconds. For longer, continue with action: "extend".
错误码
| HTTP | 含义 |
|---|---|
| 200 | 已受理,看 code |
| 401 | Token 缺失或无效 |
| 429 | 触发限流 |
常见失败:image 未传或不可访问;batchSize 传了 3;action 为 extend 但缺 index 或 taskId。
| HTTP | Meaning |
|---|---|
| 200 | Accepted; check code |
| 401 | Token missing or invalid |
| 429 | Rate limit hit |
Common failures: a missing or unreachable image; batchSize set to 3; extend without index or taskId.
使用示例
给一张图与运动幅度即可生成;同时传 image 与 endImage 会补出首尾过渡;用 action: "extend" 续接。
Send an image and a motion level to generate; adding endImage produces a start-to-end transition; action: "extend" continues an existing clip.