AI 助理
备案控制台
文档
输入文档关键字查找
首页 大模型服务平台百炼 开发参考 模型调用 通义万相系列 文生视频API参考

文生视频API参考

更新时间：
产品详情
我的收藏

本文介绍通义万相-文生视频模型的输入输出参数。

模型概览

模型效果示意

通义万相文生视频模型，一句话生成视频。视频模型具备强大的指令遵循能力，支持大幅度复杂运动、现实物理规律还原，生成的视频呈现丰富的艺术风格及影视级画面质感。您可以在通义万相官网体验文生视频的效果。

模型简介

模型名称

模型简介

wanx2.1-t2v-turbo

生成速度更快，表现均衡。

wanx2.1-t2v-plus

生成细节更丰富，画面更具质感。

模型名称

免费额度

计费单价

限流（主账号与RAM子账号共用）

任务下发接口QPS限制

同时处理中任务数量

wanx2.1-t2v-turbo

免费额度：200秒

有效期：百炼开通后180天内

0.24元/秒

2

2

wanx2.1-t2v-plus

免费额度：200秒

有效期：百炼开通后180天内

0.70元/秒

2

2

更多说明请参见模型计费及限流。

前提条件

文生视频API仅支持通过HTTP进行调用。

在调用前，您需要开通模型服务并获取API Key，再配置API Key到环境变量。

HTTP调用

文生视频模型处理时间较长，为了避免请求超时，HTTP调用仅支持异步获取模型结果。您需要发起两个请求：

  • 创建任务：首先发送一个请求创建任务，该请求会返回任务ID。

  • 根据任务ID查询结果：使用上一步获得的任务ID，查询模型生成的结果。文生视频耗时较长，查询结果时请您耐心等待。

创建任务

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

请求参数

文生视频

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2v-turbo",
    "input": {
        "prompt": "一只小猫在月光下奔跑"
    },
    "parameters": {
        "size": "1280*720"
    }
}'
请求头（Headers）

Content-Type string （必选）

请求内容类型。此参数必须设置为application/json。

Authorization string（必选）

请求身份认证。接口使用百炼API-Key进行身份认证。示例值：Bearer d1xxx2a。

X-DashScope-Async string （必选）

异步处理配置参数。HTTP请求只支持异步，必须设置为enable。

请求体（Request Body）

model string （必选）

模型名称。示例值：wanx2.1-t2v-turbo。

input object （必选）

输入的基本信息，如提示词等。

属性

prompt string （必选）

文本提示词。支持中英文，中文不超过 500 个字符，英文不超过 500 个单词，超过部分会自动截断。

示例值：一只小猫在月光下奔跑。

提示词的使用技巧请参见文生视频提示词使用指南。

prompt_extend bool （可选）

是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。

  • true：默认值，开启智能改写。

  • false：不开启智能改写。

parameters object （可选）

图像处理参数。

属性

size string （可选）

生成视频的分辨率。默认值1280*720。其中，1280代表宽度，720代表高度。

目前支持5档分辨率选择：1280*720、960*960、720*1280、1088*832、 832*1088。

duration integer （可选）

生成视频的时长，默认为5，单位为秒。目前仅支持5秒固定时长生成。

响应参数

成功响应

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

异常响应

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

output object

任务输出信息。

属性

task_id string

任务ID。

task_status string

任务状态。

枚举值

  • PENDING：任务排队中

  • RUNNING：任务处理中

  • SUSPENDED：任务挂起

  • SUCCEEDED：任务执行成功

  • FAILED：任务执行失败

  • UNKNOWN：任务不存在或状态未知

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

code string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。

message string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。

根据任务ID查询结果

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

请求参数

查询任务结果

您需要将86ecf553-d340-4e21-xxxxxxxxx替换为真实的task_id。

curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx
请求头（Headers）

Authorization string（必选）

请求身份认证。接口使用百炼API-Key进行身份认证。示例值：Bearer d1xxx2a。

URL路径参数（Path parameters）

task_id string（必选）

任务ID。

响应参数

任务执行成功

任务数据（如任务状态、视频URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的视频。

{
    "request_id": "851985d0-fbba-9d8d-a17a-xxxxxx",
    "output": {
        "task_id": "208e2fd1-fcb4-4adf-9fcc-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-01-08 16:43:27.877",
        "scheduled_time": "2025-01-08 16:43:27.908",
        "end_time": "2025-01-08 16:46:35.304",
        "video_url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.comc/aa.mp4"
    },
    "usage": {
        "video_count": 1
    }
}

任务执行失败

如果因为某种原因导致任务执行失败，任务状态将被设置为FAILED，并通过code和message字段明确指示错误原因。

{
    "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The size is not match xxxxxx"
    }
}

output object

任务输出信息。

属性

task_id string

任务ID。

task_status string

任务状态。

枚举值

  • PENDING：任务排队中

  • RUNNING：任务处理中

  • SUSPENDED：任务挂起

  • SUCCEEDED：任务执行成功

  • FAILED：任务执行失败

  • UNKNOWN：任务不存在或状态未知

submit_time string

任务提交时间。

scheduled_time string

任务执行时间。

end_time string

任务完成时间。

video_url string

视频URL。可通过此URL下载视频。

code string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。

message string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。

usage object

输出信息统计。只对成功的结果计数。

属性

video_count integer

生成视频的数量。

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

错误码

如果模型调用失败并返回报错信息，请参见错误码进行解决。

此API还有特定状态码，具体如下所示。

HTTP状态码

接口错误码（code）

含义说明

400

InvalidParamters

接口调用参数不合法

500

InternalError

内部算法错误

常见问题

模型计费及限流

免费额度

  • 额度说明：免费额度是指模型成功生成的输出视频时长。输入内容异常及模型处理失败的情况不占用免费额度。

  • 领取方式：开通阿里云百炼大模型服务后自动发放，有效期180天。

  • 使用账号：阿里云主账号与其RAM子账号共享免费额度。

  • 更多详情请参见新人免费额度。

计费说明

  • 当计费有明确单价时，如0.2元/秒，表示该模型已商业化，免费额度用尽或过期后需付费使用。

  • 计费项：只对模型成功生成的输出视频进行收费，其余情况暂不计费。

  • 付费方式：由阿里云主账号统一付费。RAM子账号不能独立计量计费，必须由所属的主账号付费。如果您需要查询账单信息，请前往阿里云控制台账单概览。

  • 充值途径：您可以在阿里云控制台费用与成本页面进行充值。

  • 模型调用情况：您可以前往百炼平台的调用统计查看模型调用量及调用次数。

  • 更多计费问题请参见计费项与定价。

限流

  • 限流说明：阿里云主账号与其RAM子账号共享限流限制。

上一篇：通义万相系列下一篇：文生图V2版API参考
文档推荐