图生视频接口文档
更新时间：2026-04-20
产品定价
| 支持能力 | 规格 | 参数设置 | 资源包扣减积分个数 |
|---|---|---|---|
| 首尾帧生视频 | 720p、1080p（有声版） | model: V aspect_resolution: 720p、1080p |
4视频积分/s |
| 首尾帧生视频 | 720p、1080p（无声版） | model: V aspect_resolution: 720p、1080p |
2视频积分/s |
| 多参考图生视频 | 720p | model: KL aspect_resolution: 720p |
1视频积分/s |
| 多参考图生视频 | 1080p | model: KL aspect_resolution: 1080p |
2视频积分/s |
接口说明
新增功能: 支持图生视频
接口调用域名：https://open.xiling.baidu.com
接口鉴权和通用字段说明请查阅：接口通用说明
图生视频接口采用异步任务模式。提交任务后返回一个或多个任务 ID，可通过查询接口轮询任务结果，也可通过回调地址接收任务完成通知。
图生视频积分仅支持本接口文档对应能力使用，不可用于其他接口。
接口列表
提交图生视频任务
POST /api/digitalhuman/open/v1/image-to-video
Content-Type: application/json;charset=utf-8
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型，可选值：V、KL |
| prompt | string | 是 | 图生视频提示词，1000 字符以内 |
| generate_count | int | 否 | 生成数量，范围 1~4 |
| image_url | string | 否 | 首帧图地址，首帧模式时必填；单张不超过 20MB；支持格式：jpg/jpeg/png/webp/bmp |
| end_image_url | string | 否 | 尾帧图地址，首帧模式下可选；单张不超过 20MB；支持格式：jpg/jpeg/png/webp/bmp |
| reference_images | string[] | 否 | 参考图地址列表，多图模式时必填；单张不超过 20MB；支持格式：jpg/jpeg/png/webp/bmp |
| aspect_ratio | string | 否 | 视频宽高比，可选值：9:16、16:9，搭配reference_images使用，使用首帧模式时不生效 |
| aspect_resolution | string | 是 | 分辨率。V 模型支持：720p、1080p；KL 模型支持：720p、1080p |
| generate_audio | boolean | 否 | 是否生成声音，仅 V 模型支持 |
| duration | int | 是 | 视频时长（秒）。V 模型支持 4、6、8；如果是多参考图模式，则只支持 8。KL 模型支持 5、10 |
| callback_url | string | 否 | 回调地址 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| task_ids | string[] | 任务 ID 列表 |
请求示例
JSON
1{
2 "model": "V",
3 "prompt": "Camera slowly pushes in on the subject, cinematic lighting, natural motion",
4 "image_url": "https://example.com/first-frame.png",
5 "aspect_ratio": "9:16",
6 "aspect_resolution": "720p",
7 "duration": 4
8}返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "task_ids": [
8 "i2v-d6b6472bcf724d0399e06d1390cb964e"
9 ]
10 }
11}回调参数
- task_type: image_to_video
- data:
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| task_id | string | 是 | 任务 ID |
| status | string | 是 | 状态：GENERATING（生成中）、SUCCEEDED（成功）、FAILED（失败） |
| video_url | string | 否 | 生成的视频地址，成功时返回 |
| thumbnail_url | string | 否 | 缩略图地址，成功时可返回 |
| error_message | string | 否 | 错误信息，失败时返回 |
回调示例
JSON
1{
2 "code": 0,
3 "msg": "ok",
4 "task_type": "image_to_video",
5 "data": {
6 "task_id": "i2v-d6b6472bcf724d0399e06d1390cb964e",
7 "status": "SUCCEEDED",
8 "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.mp4",
9 "thumbnail_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.webp",
10 "error_message": ""
11 }
12}查询图生视频任务结果
GET /api/digitalhuman/open/v1/image-to-video
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务 ID |
返回参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 否 | 任务 ID |
| status | string | 是 | 状态：GENERATING（生成中）、SUCCEEDED（成功）、FAILED（失败） |
| video_url | string | 否 | 视频地址 |
| thumbnail_url | string | 否 | 缩略图地址 |
| error_message | string | 否 | 错误信息 |
请求示例
Plain
1GET /api/digitalhuman/open/v1/image-to-video?task_id=i2v-d6b6472bcf724d0399e06d1390cb964e返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "task_id": "i2v-d6b6472bcf724d0399e06d1390cb964e",
8 "status": "SUCCEEDED",
9 "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.mp4",
10 "thumbnail_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.webp",
11 "error_message": ""
12 }
13}评价此篇文章