全部接口
查询视频生成任务(官方格式
查询万相 3.0 视频任务
Wan查询任务
创建万相 3.0 视频任务(官方格式
创建万相 3.0 视频任务
Wan图生视频
Wan文生视频
Wan首尾帧图生视频
模型信息
| 模型 ID | wan3.0-video-prime | 供应商 | Aliyun(Qwen) |
|---|---|---|---|
| 输入模态 | text、image、video、audio | 输出模态 | video |
| 分类 | video | 发布时间 | 2026-08-25 18:20:22 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| 全部接口 | 查询视频生成任务(官方格式 | 本站 AI 中转站 | GET | /qwen/api/v1/tasks/{task_id} |
| 全部接口 | 查询万相 3.0 视频任务 | 本站 AI 中转站 | GET | /v1/videos/{task_id} |
| 全部接口 | Wan查询任务 | 本站 AI 中转站 | GET | /v2/videos/generations/{task_id} |
| 全部接口 | 创建万相 3.0 视频任务(官方格式 | 本站 AI 中转站 | POST | /qwen/api/v1/services/aigc/video-generation/video-synthesis |
| 全部接口 | 创建万相 3.0 视频任务 | 本站 AI 中转站 | POST | /v1/videos |
| 全部接口 | Wan图生视频 | 本站 AI 中转站 | POST | /v2/videos/generations |
| 全部接口 | Wan文生视频 | 本站 AI 中转站 | POST | /v2/videos/generations |
| 全部接口 | Wan首尾帧图生视频 | 本站 AI 中转站 | POST | /v2/videos/generations |
GET /qwen/api/v1/tasks/{task_id}
### 查询视频生成任务(官方格式
官方文档链接：
{
"tags": [
"VideoGeneration"
],
"summary": "查询视频生成任务(官方格式",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"request_id",
"output"
],
"properties": {
"usage": {
"type": "object",
"properties": {
"SR": {
"type": "integer",
"description": "输出视频分辨率数值，例如 720。"
},
"fps": {
"type": "integer",
"default": 30,
"description": "输出视频帧率。"
},
"ratio": {
"type": "string",
"description": "输出视频宽高比。"
},
"duration": {
"type": "number",
"format": "float",
"description": "生成视频时长，单位为秒。"
},
"video_count": {
"enum": [
1
],
"type": "integer",
"description": "生成视频数量，固定为 1。"
},
"input_video_duration": {
"type": "number",
"format": "float",
"description": "输入视频总时长，单位为秒；无视频输入时为 0。"
},
"output_video_duration": {
"type": "number",
"format": "float",
"description": "输出视频时长，单位为秒。"
}
},
"description": "仅在任务成功时返回的输出统计。"
},
"output": {
"type": "object",
"required": [
"task_id",
"task_status"
],
"properties": {
"code": {
"type": "string",
"description": "任务失败时返回的错误码。"
},
"message": {
"type": "string",
"description": "任务失败时返回的错误详情。"
},
"task_id": {
"type": "string",
"description": "任务 ID。"
},
"end_time": {
"type": "string",
"examples": [
"2026-08-06 10:13:33.838"
],
"description": "任务完成时间，格式为 YYYY-MM-DD HH:mm:ss.SSS。"
},
"video_url": {
"type": "string",
"format": "uri",
"description": "成功生成的视频 URL，有效期为 24 小时。"
},
"orig_prompt": {
"type": "string",
"description": "原始提示词。"
},
"submit_time": {
"type": "string",
"examples": [
"2026-08-06 10:01:35.452"
],
"description": "任务提交时间，格式为 YYYY-MM-DD HH:mm:ss.SSS。"
},
"task_status": {
"enum": [
"PENDING",
"RUNNING",
"SUCCEEDED",
"FAILED",
"CANCELED",
"UNKNOWN"
],
"type": "string"
},
"scheduled_time": {
"type": "string",
"examples": [
"2026-08-06 10:01:35.507"
],
"description": "任务开始执行时间，格式为 YYYY-MM-DD HH:mm:ss.SSS。"
}
}
},
"request_id": {
"type": "string",
"description": "请求唯一标识。"
}
}
}
}
},
"description": "查询成功。具体字段随任务状态变化。"
},
"401": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"request_id"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"request_id": {
"type": "string"
}
}
}
}
},
"description": "API Key 缺失或无效。"
},
"default": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"request_id": {
"type": "string"
}
}
}
}
},
"description": "其他错误。"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string",
"description": "创建任务接口返回的任务 ID，有效期为 24 小时。"
},
"required": true,
"description": "创建任务接口返回的任务 ID，有效期为 24 小时。"
}
],
"description": "### 查询视频生成任务(官方格式\n官方文档链接："
}GET /v1/videos/{task_id}
### 查询万相 3.0 视频任务
建议每 15 秒轮询一次。task_id 与结果视频 URL 有效期均为 24 小时。
状态映射：
- PENDING → queued
- RUNNING → in_progress
- SUCCEEDED → completed（返回 video_url，progress=100）
- FAILED / CANCELED / UNKNOWN → failed
{
"tags": [
"qwen_wan3"
],
"summary": "查询万相 3.0 视频任务",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id",
"object",
"status"
],
"properties": {
"id": {
"type": "string",
"description": "上游 task_id。"
},
"size": {
"type": "string"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
},
"model": {
"type": "string"
},
"object": {
"type": "string",
"examples": [
"video"
]
},
"status": {
"enum": [
"queued",
"in_progress",
"completed",
"failed"
],
"type": "string"
},
"seconds": {
"type": "string",
"description": "创建时回显时长；智能时长为 auto。"
},
"progress": {
"type": "integer",
"format": "int64",
"description": "成功时为 100。"
},
"video_url": {
"type": "string",
"description": "仅 completed 时返回，有效期 24 小时。"
},
"created_at": {
"type": "integer",
"format": "int64",
"description": "Unix 秒。"
}
}
}
}
},
"description": "查询成功"
},
"400": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"type": {
"type": "string"
},
"param": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"description": "请求错误"
},
"401": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"type": {
"type": "string"
},
"param": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"description": "未授权"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string",
"description": "创建接口返回的任务 ID，可带 video_ 前缀。"
},
"required": true,
"description": "创建接口返回的任务 ID，可带 video_ 前缀。"
}
],
"description": "### 查询万相 3.0 视频任务\n建议每 15 秒轮询一次。task_id 与结果视频 URL 有效期均为 24 小时。\n\n状态映射：\n- PENDING → queued\n- RUNNING → in_progress\n- SUCCEEDED → completed（返回 video_url，progress=100）\n- FAILED / CANCELED / UNKNOWN → failed"
}GET /v2/videos/generations/{task_id}
### Wan查询任务
统一接口格式
status 枚举：
NOT_START ： 未开始
IN_PROGRESS ： 正在执行
SUCCESS ： 执行完成
FAILURE ： 失败
{
"summary": "Wan查询任务",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "### Wan查询任务\n统一接口格式\nstatus 枚举：\nNOT_START ： 未开始\nIN_PROGRESS ： 正在执行\nSUCCESS ： 执行完成\nFAILURE ： 失败",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Wan查询任务",
"$schema": "",
"required": [
"prompt",
"model"
],
"properties": {
"seed": {
"type": "integer"
},
"size": {
"type": "string"
},
"model": {
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "string"
}
},
"prompt": {
"type": "string"
},
"duration": {
"type": "integer"
},
"template": {
"type": "string"
},
"watermark": {
"type": "boolean"
},
"resolution": {
"type": "string"
},
"prompt_extend": {
"type": "string"
},
"negative_prompt": {
"type": "string"
}
},
"x-apifox-id": "342240878"
}
}
},
"required": true
}
}POST /qwen/api/v1/services/aigc/video-generation/video-synthesis
### 创建万相 3.0 视频任务(官方格式
创建异步视频生成任务。`input.prompt` 和 `input.media` 至少填写一个。
`reference_*`、`file`、`link` 类型不能与 `first_frame`、`last_frame` 类型混用。
官方文档链接：
{
"tags": [
"VideoGeneration"
],
"summary": "创建万相 3.0 视频任务(官方格式",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"output",
"request_id"
],
"properties": {
"output": {
"type": "object",
"required": [
"task_id",
"task_status"
],
"properties": {
"task_id": {
"type": "string",
"description": "任务 ID，有效期为 24 小时。"
},
"task_status": {
"enum": [
"PENDING",
"RUNNING",
"SUCCEEDED",
"FAILED",
"CANCELED",
"UNKNOWN"
],
"type": "string"
}
}
},
"request_id": {
"type": "string",
"description": "请求唯一标识。"
}
}
}
}
},
"description": "任务创建成功。"
},
"400": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"request_id"
],
"properties": {
"code": {
"type": "string",
"description": "错误码。"
},
"message": {
"type": "string",
"description": "错误详情。"
},
"request_id": {
"type": "string",
"description": "请求唯一标识。"
}
}
}
}
},
"description": "请求参数错误。"
},
"401": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"request_id"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"request_id": {
"type": "string"
}
}
}
}
},
"description": "API Key 缺失或无效。"
},
"default": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"request_id": {
"type": "string"
}
}
}
}
},
"description": "其他错误。"
}
},
"parameters": [],
"description": "### 创建万相 3.0 视频任务(官方格式\n创建异步视频生成任务。`input.prompt` 和 `input.media` 至少填写一个。\n`reference_*`、`file`、`link` 类型不能与 `first_frame`、`last_frame` 类型混用。\n官方文档链接：",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "创建万相 3.0 视频任务(官方格式",
"$schema": "",
"required": [
"model",
"input"
],
"properties": {
"input": {
"type": "object",
"anyOf": [
{
"required": [
"prompt"
]
},
{
"required": [
"media"
]
}
],
"properties": {
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"url": {
"type": "string",
"examples": [
""
],
"description": "公网 HTTP(S) URL、OSS 临时 URL；图片还可传入\n`data:{MIME_type};base64,{base64_data}` 格式的数据。"
},
"type": {
"enum": [
"first_frame",
"last_frame",
"reference_image",
"reference_video",
"reference_audio",
"file",
"link"
],
"type": "string",
"description": "媒体素材类型。"
}
}
},
"minItems": 1,
"description": "媒体素材列表。图片最多 10 张；视频最多 5 段且总时长不超过 15 秒；\n音频最多 5 段且总时长不超过 15 秒；文件或网页链接最多 1 个且二者互斥；\n首帧、尾帧各最多 1 张。各类素材的组合限制需由调用方遵守。"
},
"prompt": {
"type": "string",
"maxLength": 20000,
"description": "描述期望生成的视频内容，支持中英文。全能参考模式下可使用“图1”、\n“视频1”、“音频1”等称呼引用 media 中同类素材的出现顺序。"
}
},
"description": "输入信息。prompt 和 media 至少填写一个。",
"minProperties": 1
},
"model": {
"enum": [
"wan3.0-video-prime",
"wan3.0-video"
],
"type": "string",
"description": "模型名称。"
},
"parameters": {
"type": "object",
"properties": {
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "用于复现生成结果的随机种子。"
},
"audio": {
"type": "boolean",
"default": true,
"description": "输出视频是否包含音轨。"
},
"ratio": {
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"default": "adaptive",
"description": "输出视频宽高比。"
},
"duration": {
"type": "integer",
"default": 5,
"description": "输出时长（秒）。`-1` 表示智能时长；无视频输入时可取 2～30；\n有视频输入时，输入视频总时长与输出视频时长之和不得超过 30 秒。"
},
"watermark": {
"type": "boolean",
"default": false,
"description": "是否添加水印标识。"
},
"resolution": {
"enum": [
"1080P",
"720P",
"480P"
],
"type": "string",
"default": "1080P",
"description": "输出分辨率档位。"
},
"prompt_extend": {
"type": "boolean",
"default": true,
"description": "是否启用提示词智能改写。"
}
},
"description": "视频生成参数。"
}
},
"x-apifox-id": "505913152"
}
}
},
"required": true
}
}POST /v1/videos
### 创建万相 3.0 视频任务
统一支持文生视频、图生视频（首帧 / 首尾帧）和参考生视频。
prompt 与媒体素材至少提供其一。
模式推断（未传 mode 且未传官方 media 时）：
- 有视频 / 音频 / file / link：参考生视频
- 正好 1 或 2 张图：图生视频（第 1 张为首帧，第 2 张为尾帧）
- 其他：参考生视频
reference_* / file / link 与 first_frame / last_frame 互斥，不能混用。
{
"tags": [
"qwen_wan3"
],
"summary": "创建万相 3.0 视频任务",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id",
"object",
"status"
],
"properties": {
"id": {
"type": "string",
"description": "上游 task_id。"
},
"size": {
"type": "string"
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
},
"model": {
"type": "string"
},
"object": {
"type": "string",
"examples": [
"video"
]
},
"status": {
"enum": [
"queued",
"in_progress",
"completed",
"failed"
],
"type": "string"
},
"seconds": {
"type": "string",
"description": "创建时回显时长；智能时长为 auto。"
},
"progress": {
"type": "integer",
"format": "int64",
"description": "成功时为 100。"
},
"video_url": {
"type": "string",
"description": "仅 completed 时返回，有效期 24 小时。"
},
"created_at": {
"type": "integer",
"format": "int64",
"description": "Unix 秒。"
}
}
}
}
},
"description": "任务已提交"
},
"400": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"type": {
"type": "string"
},
"param": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"description": "请求错误"
},
"401": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"type": {
"type": "string"
},
"param": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
}
}
},
"description": "未授权"
}
},
"parameters": [],
"description": "### 创建万相 3.0 视频任务\n统一支持文生视频、图生视频（首帧 / 首尾帧）和参考生视频。\nprompt 与媒体素材至少提供其一。\n\n模式推断（未传 mode 且未传官方 media 时）：\n- 有视频 / 音频 / file / link：参考生视频\n- 正好 1 或 2 张图：图生视频（第 1 张为首帧，第 2 张为尾帧）\n- 其他：参考生视频\n\nreference_* / file / link 与 first_frame / last_frame 互斥，不能混用。",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "创建万相 3.0 视频任务",
"$schema": "",
"required": [
"model",
"prompt"
],
"properties": {
"file": {
"type": "string",
"description": "参考文件 URL。不可与 link 同时传。也可用 fileUrl。"
},
"link": {
"type": "string",
"description": "公开网页 URL。不可与 file 同时传。也可用 linkUrl。"
},
"mode": {
"enum": [
"image-to-video",
"reference-to-video"
],
"type": "string",
"description": "未传 media 时生效。自动推导用什么mode"
},
"seed": {
"type": "integer",
"description": "随机种子，大于 0 时传给上游。范围 0 到 2147483647。"
},
"audio": {
"type": "boolean",
"default": true,
"description": "输出是否含音轨，默认 true。"
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "公网 URL、OSS 临时 URL 或图像 Base64 data URI。"
},
"type": {
"enum": [
"first_frame",
"last_frame",
"reference_image",
"reference_video",
"reference_audio",
"file",
"link"
],
"type": "string"
}
}
},
"description": "官方格式媒体数组。传入后不再按 image_urls 等字段推断。reference_* / file / link 与 first_frame / last_frame / video_urls/ audio_urls / file / link 互斥。"
},
"model": {
"enum": [
"wan3.0-video",
"wan3.0-video-prime"
],
"type": "string",
"examples": [
"wan3.0-video"
]
},
"prompt": {
"type": "string",
"description": "文本提示词，中英文均可，最长 20000 字符。参考模式下可用「图1」「视频1」指代 media 顺序。"
},
"duration": {
"type": "integer",
"examples": [
5
],
"description": "也支持字段名称 seconds。"
},
"watermark": {
"type": "boolean",
"default": false,
"description": "是否加水印，默认 false。"
},
"audio_urls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"description": "参考音频。最多 5 段。也可用 audioUrls、input_audio、audio_url。"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"description": "图片列表。也可用 imageUrls、images、input_reference、first_frame_url、last_frame_url。"
},
"resolution": {
"enum": [
"480P",
"720P",
"1080P"
],
"type": "string",
"default": "1080P",
"description": "未识别时默认 1080P。"
},
"video_urls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"description": "参考视频。最多 5 段，总时长不超过 15 秒。也可用 videoUrls、input_video、video_url。"
},
"aspect_ratio": {
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"default": "adaptive",
"description": "也可用从 size 推导。无法识别时为 adaptive。"
},
"prompt_extend": {
"type": "boolean",
"default": true,
"description": "是否智能改写 prompt，默认 true。"
}
},
"description": "prompt 与媒体素材至少提供其一。也可直接传官方 input / parameters。",
"x-apifox-id": "505897644"
}
}
},
"required": true
}
}POST /v2/videos/generations
### Wan图生视频
统一接口格式
{
"summary": "Wan图生视频",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### Wan图生视频\n统一接口格式",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Wan图生视频",
"$schema": "",
"required": [
"prompt",
"images",
"model"
],
"properties": {
"seed": {
"type": "integer"
},
"model": {
"enum": [
"wan2.2-i2v-plus",
"wan2.2-i2v-flash",
"wanx2.1-i2v-turbo",
"wanx2.1-i2v-plus"
],
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "string"
},
"description": "仅支持一张参考图"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "integer"
},
"template": {
"type": "string"
},
"watermark": {
"type": "boolean"
},
"resolution": {
"enum": [
"720P",
"480P",
"1080P"
],
"type": "string",
"description": "wan2.2-i2v-plus：有效值：480P 和 1080P。默认值：1080P\nwan2.2-i2v-flash：有效值：480P 和 720P。默认值：720P\nwanx2.1-i2v-plus：有效值：720P。默认值：720P\nwanx2.1-i2v-turbo：有效值：480P 和 720P。默认值：720P"
},
"prompt_extend": {
"type": "string"
},
"negative_prompt": {
"type": "string"
}
},
"x-apifox-id": "342181510"
}
}
},
"required": true
}
}POST /v2/videos/generations
### Wan文生视频
通义万相文生视频模型基于文本提示词，生成一段流畅的视频。支持的能力包括：
基础能力：时长灵活（5秒/10秒）、指定视频分辨率（480P/720P/1080P）、智能改写prompt、添加水印。
音频能力：支持自动配音，或传入自定义音频文件，实现音画同步。（仅wan2.5支持）
{
"summary": "Wan文生视频",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### Wan文生视频\n通义万相文生视频模型基于文本提示词，生成一段流畅的视频。支持的能力包括：\n\n基础能力：时长灵活（5秒/10秒）、指定视频分辨率（480P/720P/1080P）、智能改写prompt、添加水印。\n\n音频能力：支持自动配音，或传入自定义音频文件，实现音画同步。（仅wan2.5支持）",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Wan文生视频",
"$schema": "",
"required": [
"prompt",
"model"
],
"properties": {
"seed": {
"type": "integer",
"description": "一个随机数种子，用于控制模型生成的内容的随机性。该值必须在 [0， 2147483647] 的范围内。\n如果不提供此参数，则算法会自动为种子生成一个随机数。如果希望生成的内容保持相对稳定，可以使用相同的种子值。"
},
"size": {
"type": "string",
"description": "wan2.2-t2v-plus：支持所有对应 480P 和 1080P 的分辨率。默认分辨率为 1920x1080\nwanx2.1-t2v-turbo：支持所有对应 480P 和 720P 的分辨率。默认分辨率为 1280×720 （720P）。\nwanx2.1-t2v-plus：仅支持 720P 对应的分辨率。默认分辨率为 1280×720 （720P）。\n480P: The optional video resolutions and their corresponding aspect ratios are:\n480P：可选的视频分辨率及其相应的宽高比为：\n\n832×480: 16:9. 832×480：16：9。\n\n480×832: 9:16. 480×832：9：16。\n\n624×624: 1:1. 624×624：1。\n\n720P: The optional video resolutions and their corresponding aspect ratios are:\n720P：可选的视频分辨率及其相应的宽高比为：\n\n1280×720: 16:9. 1280×720：16：9。\n\n720×1280: 9:16. 720×1280：9：16。\n\n960×960: 1:1. 960×960：1：1。\n\n1088×832: 4:3. 1088×832：4：3。\n\n832×1088: 3:4. 832×1088：3：4。\n\n1080P: The optional video resolutions and their corresponding aspect ratios are:\n1080P：可选的视频分辨率及其相应的宽高比为：\n\n1920×1080: 16:9.\n1920×1080：16：9。\n\n1080×1920: 9:16.\n1080×1920：9：16。\n\n1440×1440: 1:1. 1440×1440：1：1。\n\n1632×1248: 4:3. 1632×1248：4：3。\n\n1248×1632: 3:4. 1248×1632：3：4。"
},
"model": {
"enum": [
"wan2.2-t2v-plus",
"wanx2.1-t2v-turbo",
"wanx2.1-t2v-plus"
],
"type": "string",
"description": "型号名称。示例：wan2.1-t2v-turbo。"
},
"prompt": {
"type": "string",
"description": "The text prompt supports Chinese and English, with a maximum length of 800 characters. Each Chinese character or letter counts as one character. Content that exceeds this limit will be truncated.\n文本提示支持中英文，最大长度为800个字符。每个汉字或字母算作一个字符。超过此限制的内容将被截断。\n\nExample: A kitten running in the moonlight.\n示例：一只小猫在月光下奔跑。"
},
"duration": {
"type": "integer",
"description": "生成视频的持续时间（以秒为单位）。该参数固定为 5，无法修改。模型始终生成一个 5 秒的视频。"
},
"template": {
"type": "string"
},
"watermark": {
"type": "boolean",
"description": "指定是否添加水印。水印位于视频的右下角，注明“由人工智能生成”。"
},
"prompt_extend": {
"type": "boolean",
"description": "指定是否启用提示重写。如果启用，则使用大型语言模型 （LLM） 智能重写输入提示。这显着改善了较短提示的生成结果，但增加了处理时间。"
},
"negative_prompt": {
"type": "string",
"description": "A negative prompt is used to describe content that you do not want to appear in the video, which lets you restrict the video content.\n否定提示用于描述您不想出现在视频中的内容，这可以让您限制视频内容。\n\nIt supports Chinese and English, with a maximum length of 500 characters. Content that exceeds this limit will be truncated.\n它支持中英文，最大长度为 500 个字符。超过此限制的内容将被截断。\n\nExamples: low resolution, error, worst quality, low quality, defects, extra fingers, poor proportions.\n例如：低分辨率、错误、质量最差、质量低、缺陷、多余手指、比例差。"
}
},
"x-apifox-id": "342290999"
}
}
},
"required": true
}
}POST /v2/videos/generations
### Wan首尾帧图生视频
统一接口格式
{
"summary": "Wan首尾帧图生视频",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### Wan首尾帧图生视频\n统一接口格式",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Wan首尾帧图生视频",
"$schema": "",
"required": [
"prompt",
"model",
"images"
],
"properties": {
"seed": {
"type": "integer"
},
"model": {
"enum": [
"wanx2.1-kf2v-plus"
],
"type": "string",
"description": "wanx2.1-kf2v-plus"
},
"images": {
"type": "array",
"items": {
"type": "string"
},
"description": "第一张是首帧，第二张是尾帧\n使用公网可访问URL\n\n支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。\n\n示例值：\n\n传入 Base64 编码图像后的字符串\n\n数据格式：data:{MIME_type};base64,{base64_data}。\n\n示例值：data:image/png;base64,GDU7MtCZzEbTbmRZ......。（编码字符串过长，仅展示片段）"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "integer"
},
"template": {
"type": "string"
},
"watermark": {
"type": "boolean"
},
"resolution": {
"type": "string"
},
"prompt_extend": {
"type": "string"
},
"negative_prompt": {
"type": "string"
}
},
"x-apifox-id": "342291320"
}
}
},
"required": true
}
}价格
| 价格组 | 渠道 | 计费项 | 价格 | 单位 |
|---|---|---|---|---|
| default | 本站 AI 中转站 | duration | CNY 0.45 | s |
服务级错误码参照(error_code)：
| 错误码 | 说明 | |
|---|---|---|
| 221301 | 数据源超时 | |
| 221303 | 认证失败 认证失败，请稍后重试 认证失败,该卡当日连续多次认证不通过被限制校验,次日恢复 |
|
| 221306 | 参数错误 参数错误：姓名格式不正确 参数错误：手机号格式不正确 参数错误：身份证格式不正确 参数错误：银行卡号格式不正确 同一银行卡请求过于频繁 |
系统级错误码参照：
| 错误码 | 说明 | |
|---|---|---|
| 10001 | 错误的请求KEY | |
| 10002 | 该KEY无请求权限 | |
| 10003 | KEY过期 | |
| 10004 | 错误的OPENID | |
| 10005 | 应用未审核超时，请提交认证 | |
| 10007 | 未知的请求源 | |
| 10008 | 被禁止的IP | |
| 10009 | 被禁止的KEY | |
| 10011 | 当前IP请求超过限制 | |
| 10012 | 请求超过次数限制 | |
| 10013 | 测试KEY超过请求限制 | |
| 10014 | 系统内部异常(调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失) | |
| 10020 | 接口维护 | |
| 10021 | 接口停用 |
错误码格式说明（示例：200201）：
| 2 | 002 | 01 | |
|---|---|---|---|
| 服务级错误（1为系统级错误） | 服务模块代码(即数据ID) | 具体错误代码 |
使用文档下载
| 附件标题/下载链接 | 更新时间 | |
|---|---|---|
| 接口资料：GET /qwen/api/v1/tasks/{task_id}（查询视频生成任务(官方格式） | 2026-09-09 15:29:05 | |
| 接口资料：GET /v1/videos/{task_id}（查询万相 3.0 视频任务） | 2026-09-09 15:29:05 | |
| 接口资料：GET /v2/videos/generations/{task_id}（Wan查询任务） | 2026-09-09 15:29:05 | |
| 接口资料：POST /qwen/api/v1/services/aigc/video-generation/video-synthesis（创建万相 3.0 视频任务(官方格式） | 2026-09-09 15:29:05 | |
| 接口资料：POST /v1/videos（创建万相 3.0 视频任务） | 2026-09-09 15:29:05 | |
| 接口资料：POST /v2/videos/generations（Wan图生视频） | 2026-09-09 15:29:05 | |
| 接口资料：POST /v2/videos/generations（Wan文生视频） | 2026-09-09 15:29:05 | |
| 接口资料：POST /v2/videos/generations（Wan首尾帧图生视频） | 2026-09-09 15:29:05 | |
| 价格分组：default（CNY 0.45/s） | 2026-09-09 15:29:05 | |
| 阶梯与倍率计费资料 | 2026-09-09 15:29:05 | |
| 供应商令牌分组折扣资料 | 2026-09-09 15:29:05 |
常见问题：
| 标题 | 更新时间 | |
|---|---|---|
| Token 是什么？中文、英文与上下文窗口如何计算 | 2026-09-18 19:52:51 | |
| LLM API 费用如何计算？如何选择合适的模型 | 2026-09-18 19:52:54 | |
| Word-to-Token 转换与用量估算指南 | 2026-09-19 00:49:28 |
gemini-3.8-flash-thinking-medium
gemini-3.8-flash-thinking-high
京公网安备11010802020088号