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

创建文生视频任务

功能介绍

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

URI

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

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

deployment_id

是

String

参数解释：

模型的部署ID，获取方法请参见获取模型部署ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

Content-Type

是

String

参数解释：

发送的实体的MIME类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json
表3 请求Body参数

参数

是否必选

参数类型

描述

prompt

是

String

参数解释：

提示词。

约束限制：

支持中英文。长度小于等于1000。

取值范围：

不涉及。

默认取值：

不涉及。

video_config

否

VideoConfig object

生成视频的配置信息
表4 VideoConfig

参数

是否必选

参数类型

描述

resolution

否

String

参数解释：

分辨率。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

720p

duration

否

int

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

5

aspect_ratio

否

String

参数解释：

生成的视频宽高比。

约束限制：

不涉及。

取值范围：

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

默认取值：

16:9

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

id

String

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

prompt

String

提示词。

status

String

视频生成的任务状态。

video_url

String

视频生成结果文件链接。

video_config

VideoConfig object

生成视频的配置信息。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

error_code

String

错误码

请求示例

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

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

Request Body:
{
    "prompt": "prompt",
    "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"
    }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 多模态模型

相关文档