文档首页/ 盘古大模型 PanguLargeModels/ API参考/ API/ 模型推理接口/ 多模态模型/ 创建图生视频任务
更新时间：2025-09-16 GMT+08:00
查看PDF
分享

创建图生视频任务

功能介绍

支持调用多模态视频大模型创建图生视频的推理任务。

URI

POST /v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos

获取URI方式请参见请求URI。

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

Content-Type

是

String

参数解释：

发送的实体的MIME类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json
表2 请求Body参数

参数

是否必选

参数类型

描述

prompt

是

String

参数解释：

提示词。

约束限制：

支持中英文。

取值范围：

长度小于等于1000。

默认取值：

不涉及。

image

否

String

参数解释：

首帧图片base64或首帧图片URL。

约束限制：

image字段和image_tail字段不能同时为空。

图片base64小于10M。

取值范围：

不涉及。

默认取值：

不涉及。

image_tail

否

String

参数解释：

尾帧图片base64或尾帧图片URL。

约束限制：

image字段和image_tail字段不能同时为空。

图片base64小于10M。

取值范围：

不涉及。

默认取值：

不涉及。

video_config

否

VideoConfig object

生成视频的配置信息。
表3 VideoConfig

参数

是否必选

参数类型

描述

resolution

否

String

参数解释：

分辨率。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

720p

duration

否

int

参数解释：

生成的视频时长，单位秒。

约束限制：

无。

取值范围：

不涉及。

默认取值：

5

aspect_ratio

否

String

参数解释：

生成的视频宽高比。

约束限制：

不涉及。

取值范围：

16:9、9:16、4:3、3:4、1:1、original

默认取值：

16:9

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

id

String

用来标识视频生成任务的唯一字符串。

prompt

String

提示词。

status

String

视频生成的任务状态。

video_url

Strng

视频生成结果文件链接。

video_config

VideoConfig object

生成视频的配置信息。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

error_code

String

错误码

请求示例

POST https://{endpoint}/v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos

Request Header:   
Content-Type: application/json   
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      

Request Body:
{
    "prompt": "prompt",
    "image": "https://xxx.obs.cnxxx",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}

响应示例

{
    "id": "e7c33de0-1245-42d9-a875-745845ce3b22",
    "prompt": "prompt",
    "status": "PROCESSING",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 多模态模型

相关文档