viduq3-turbo

视频异步任务

Vidu 视频模型，适配官方 API 格式

¥--已优惠

----

申请赠送05000000 Tokens

约¥0/ 5百万Tokens
一元试用11000000 Tokens

约¥1/百万Token
默认0.028125积分

按量计费
国产特价20.0225积分

按量计费

· 首次申请送500万Token

立即使用

客服

使用

使用文档
附件资料
计费明细

使用文档

全部接口

查询任务

图生视频

参考生视频

首尾帧

文生视频

错误码

错误码列表

资源下载

使用文档下载

模型信息

模型 ID	viduq3-turbo	供应商	Vidu
输入模态	未注明	输出模态	未注明
分类	未注明	发布时间	2025-11-19 18:52:21

调用接口

分组	接口	渠道	方法	路径
全部接口	查询任务	本站 AI 中转站	GET	/vidu/v2/tasks/{task_id}/creations
全部接口	图生视频	本站 AI 中转站	POST	/vidu/v2/img2video
全部接口	参考生视频	本站 AI 中转站	POST	/vidu/v2/reference2video
全部接口	首尾帧	本站 AI 中转站	POST	/vidu/v2/start-end2video
全部接口	文生视频	本站 AI 中转站	POST	/vidu/v2/text2video

GET /vidu/v2/tasks/{task_id}/creations

请求与响应结构

{
    "summary": "查询任务",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [
        {
            "in": "path",
            "name": "task_id",
            "schema": {
                "type": "string"
            },
            "required": true,
            "description": ""
        }
    ],
    "description": "",
    "requestBody": {
        "content": {
            "text/plain": {
                "schema": {
                    "type": "object",
                    "title": "查询任务",
                    "$schema": "",
                    "x-apifox-id": "374481817"
                }
            }
        },
        "required": true
    }
}

POST /vidu/v2/img2video

### 图生视频
### 参数名称及描述

| 参数名称 | 类型 | 必填 | 参数描述 |
|------------------|------------|------|---------|
| `model` | String | 是 | 模型名称，可选值： - `viduq2-pro`: 新模型，效果好，细节丰富 - `viduq2-turbo`: 新模型，效果好，生成快 - `viduq1`: 画面清晰，平滑转场，运镜稳定 - `viduq1-classic`: 画面清晰，转场、运镜更丰富 - `vidu2.0`: 生成速度快 - `vidu1.5`: 动态幅度大 |
| `images` | Array[String] | 是 | 首帧图像。支持 Base64 编码或图片 URL，支持格式：png、jpeg、jpg、webp。图片比例需小于 1:4 或 4:1，大小不超过 50 MB。 |
| `prompt` | String | 可选 | 生成视频的文本描述，字符长度不超过 2000 个字符。 |
| `is_rec` | Bool | 可选 | 是否使用推荐提示词： - `true`: 系统自动推荐提示词，生成视频时使用推荐词（推荐提示词数量=1） - `false`: 使用自定义提示词生成视频。启用推荐提示词每个任务额外消耗10积分。 |
| `duration` | Int | 可选 | 视频时长，依据模型默认值设置： - `viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`: 默认为 5秒，可选：1、2、3、4、5、6、7、8 - `vidu2.0`: 默认为 4秒，可选：4、8 - `vidu1.5`: 默认为 4秒，可选：4、8 |
| `seed` | Int | 可选 | 随机种子。默认不传或传0时使用随机数替代，手动设置则使用设置的种子。 |
| `resolution` | String | 可选 | 分辨率： - `viduq2-pro`: 1-8秒，默认 720p，可选：540p、720p、1080p - `viduq1`、`viduq1-classic`: 默认 1080p - `vidu2.0`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p - `vidu1.5`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p |
| `movement_amplitude` | String | 可选 | 运动幅度：默认 `auto`，可选值：`auto`、`small`、`medium`、`large` |
| `bgm` | Bool | 可选 | 是否添加背景音乐，默认为 `false`。若 `true`，系统自动挑选并添加合适音乐。 |
| `payload` | String | 可选 | 透传参数，最大字符长度为 1048576。 |
| `off_peak` | Bool | 可选 | 错峰模式，默认为 `false`，可选值：`true`（错峰生成），`false`（即时生成）。错峰模式消耗积分较低，任务会在48小时内生成。 |
| `watermark` | Bool | 可选 | 是否添加水印，`true` 表示添加水印，`false` 表示不添加。默认不加。 |
| `wm_position` | Int | 可选 | 水印位置： - 1: 左上角 - 2: 右上角 - 3: 右下角 - 4: 左下角 默认：3 |
| `wm_url` | String | 可选 | 自定义水印内容的图片 URL，若不传，使用默认水印。 |
| `meta_data` | String | 可选 | 元数据标识，JSON 格式字符串，可自定义或使用示例格式。 |

### 示例格式

```json
{
"Label": "your_label",
"ContentProducer": "yourcontentproducer",
"ContentPropagator": "your_content_propagator",
"ProduceID": "yourproductid",
"PropagateID": "your_propagate_id",
"ReservedCode1": "yourreservedcode1",
"ReservedCode2": "your_reserved_code2"
}

请求与响应结构

{
    "summary": "图生视频",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "### 图生视频\n### 参数名称及描述\n\n| 参数名称           | 类型         | 必填 | 参数描述 |\n|------------------|------------|------|---------|\n| `model`          | String     | 是   | 模型名称， 可选值：<br> - `viduq2-pro`: 新模型，效果好，细节丰富<br> - `viduq2-turbo`: 新模型，效果好，生成快<br> - `viduq1`: 画面清晰，平滑转场，运镜稳定<br> - `viduq1-classic`: 画面清晰，转场、运镜更丰富<br> - `vidu2.0`: 生成速度快<br> - `vidu1.5`: 动态幅度大 |\n| `images`         | Array[String] | 是   | 首帧图像。支持 Base64 编码或图片 URL，支持格式：png、jpeg、jpg、webp。图片比例需小于 1:4 或 4:1，大小不超过 50 MB。 |\n| `prompt`         | String     | 可选 | 生成视频的文本描述，字符长度不超过 2000 个字符。 |\n| `is_rec`         | Bool       | 可选 | 是否使用推荐提示词：<br> - `true`: 系统自动推荐提示词，生成视频时使用推荐词（推荐提示词数量=1）<br> - `false`: 使用自定义提示词生成视频。启用推荐提示词每个任务额外消耗10积分。 |\n| `duration`       | Int        | 可选 | 视频时长，依据模型默认值设置：<br> - `viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`: 默认为 5秒，可选：1、2、3、4、5、6、7、8<br> - `vidu2.0`: 默认为 4秒，可选：4、8<br> - `vidu1.5`: 默认为 4秒，可选：4、8 |\n| `seed`           | Int        | 可选 | 随机种子。默认不传或传0时使用随机数替代，手动设置则使用设置的种子。 |\n| `resolution`     | String     | 可选 | 分辨率：<br> - `viduq2-pro`: 1-8秒，默认 720p，可选：540p、720p、1080p<br> - `viduq1`、`viduq1-classic`: 默认 1080p<br> - `vidu2.0`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p<br> - `vidu1.5`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p |\n| `movement_amplitude` | String  | 可选 | 运动幅度：默认 `auto`，可选值：`auto`、`small`、`medium`、`large` |\n| `bgm`            | Bool       | 可选 | 是否添加背景音乐，默认为 `false`。若 `true`，系统自动挑选并添加合适音乐。 |\n| `payload`        | String     | 可选 | 透传参数，最大字符长度为 1048576。 |\n| `off_peak`       | Bool       | 可选 | 错峰模式，默认为 `false`，可选值：`true`（错峰生成），`false`（即时生成）。错峰模式消耗积分较低，任务会在48小时内生成。 |\n| `watermark`      | Bool       | 可选 | 是否添加水印，`true` 表示添加水印，`false` 表示不添加。默认不加。 |\n| `wm_position`    | Int        | 可选 | 水印位置：<br> - 1: 左上角<br> - 2: 右上角<br> - 3: 右下角<br> - 4: 左下角<br> 默认：3 |\n| `wm_url`         | String     | 可选 | 自定义水印内容的图片 URL，若不传，使用默认水印。 |\n| `meta_data`      | String     | 可选 | 元数据标识，JSON 格式字符串，可自定义或使用示例格式。 |\n\n### 示例格式\n\n```json\n{\n  \"Label\": \"your_label\",\n  \"ContentProducer\": \"yourcontentproducer\",\n  \"ContentPropagator\": \"your_content_propagator\",\n  \"ProduceID\": \"yourproductid\",\n  \"PropagateID\": \"your_propagate_id\",\n  \"ReservedCode1\": \"yourreservedcode1\",\n  \"ReservedCode2\": \"your_reserved_code2\"\n}",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "图生视频",
                    "$schema": "",
                    "required": [
                        "model",
                        "images",
                        "prompt",
                        "duration",
                        "seed",
                        "resolution",
                        "movement_amplitude",
                        "off_peak"
                    ],
                    "properties": {
                        "seed": {
                            "type": "integer"
                        },
                        "model": {
                            "type": "string"
                        },
                        "images": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "prompt": {
                            "type": "string"
                        },
                        "duration": {
                            "type": "integer"
                        },
                        "off_peak": {
                            "type": "boolean"
                        },
                        "resolution": {
                            "type": "string"
                        },
                        "movement_amplitude": {
                            "type": "string"
                        }
                    },
                    "x-apifox-id": "374481658"
                }
            }
        },
        "required": true
    }
}

POST /vidu/v2/reference2video

### 参考生视频
具体参数请看官方文档：

请求与响应结构

{
    "summary": "参考生视频",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "### 参考生视频\n具体参数请看官方文档：",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "参考生视频",
                    "$schema": "",
                    "required": [
                        "model",
                        "images",
                        "prompt",
                        "duration",
                        "seed",
                        "resolution",
                        "movement_amplitude",
                        "off_peak"
                    ],
                    "properties": {
                        "seed": {
                            "type": "integer"
                        },
                        "model": {
                            "type": "string"
                        },
                        "images": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "prompt": {
                            "type": "string"
                        },
                        "duration": {
                            "type": "integer"
                        },
                        "off_peak": {
                            "type": "boolean"
                        },
                        "resolution": {
                            "type": "string"
                        },
                        "movement_amplitude": {
                            "type": "string"
                        }
                    },
                    "x-apifox-id": "374481783"
                }
            }
        },
        "required": true
    }
}

POST /vidu/v2/start-end2video

### 首尾帧
具体参数请看官方文档：

请求与响应结构

{
    "summary": "首尾帧",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "### 首尾帧\n具体参数请看官方文档：",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "首尾帧",
                    "$schema": "",
                    "required": [
                        "model",
                        "images",
                        "prompt",
                        "duration",
                        "seed",
                        "resolution",
                        "movement_amplitude",
                        "off_peak"
                    ],
                    "properties": {
                        "seed": {
                            "type": "integer"
                        },
                        "model": {
                            "type": "string"
                        },
                        "images": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "prompt": {
                            "type": "string"
                        },
                        "duration": {
                            "type": "integer"
                        },
                        "off_peak": {
                            "type": "boolean"
                        },
                        "resolution": {
                            "type": "string"
                        },
                        "movement_amplitude": {
                            "type": "string"
                        }
                    },
                    "x-apifox-id": "374481785"
                }
            }
        },
        "required": true
    }
}

POST /vidu/v2/text2video

### 文生视频
具体参数请看官方文档：

请求与响应结构

{
    "summary": "文生视频",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": []
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "### 文生视频\n具体参数请看官方文档：",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "文生视频",
                    "$schema": "",
                    "required": [
                        "model",
                        "images",
                        "prompt",
                        "duration",
                        "seed",
                        "resolution",
                        "movement_amplitude",
                        "off_peak"
                    ],
                    "properties": {
                        "seed": {
                            "type": "integer"
                        },
                        "model": {
                            "type": "string"
                        },
                        "images": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "prompt": {
                            "type": "string"
                        },
                        "duration": {
                            "type": "integer"
                        },
                        "off_peak": {
                            "type": "boolean"
                        },
                        "resolution": {
                            "type": "string"
                        },
                        "movement_amplitude": {
                            "type": "string"
                        }
                    },
                    "x-apifox-id": "374481802"
                }
            }
        },
        "required": true
    }
}

价格

价格组	渠道	计费项	价格	单位
default	AI 中转站	request	CNY 0.028125	积分
国产特价2	AI 中转站	request	CNY 0.0225	积分

服务级错误码参照(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 /vidu/v2/tasks/{task_id}/creations（查询任务）	2026-11-02 17:04:57
	接口资料：POST /vidu/v2/img2video（图生视频）	2026-11-02 17:04:57
	接口资料：POST /vidu/v2/reference2video（参考生视频）	2026-11-02 17:04:57
	接口资料：POST /vidu/v2/start-end2video（首尾帧）	2026-11-02 17:04:57
	接口资料：POST /vidu/v2/text2video（文生视频）	2026-11-02 17:04:57
	价格分组：default（CNY 0.028125/积分）	2026-11-02 17:04:57
	价格分组：国产特价2（CNY 0.0225/积分）	2026-11-02 17:04:57
	供应商令牌分组折扣资料	2026-11-02 17:04:57

常见问题：

	标题	更新时间
	Token 是什么？中文、英文与上下文窗口如何计算	2026-11-04 14:16:20
	LLM API 费用如何计算？如何选择合适的模型	2026-11-04 14:36:14
	Word-to-Token 转换与用量估算指南	2026-11-04 12:35:17

计费项	估算单价	单位	倍率依据
request	⚡0.028125	积分	按量计费

扩展计费信息	分组倍率 1
提示	估算费用请使用此分组建立令牌。

计费项	估算单价	单位	倍率依据
request	⚡0.0225	积分	按量计费

扩展计费信息	分组倍率 0.8
提示	估算费用请使用此分组建立令牌。

viduq3-turbo

--: 今日调用

--: 成功率

--: 近期调用

帮助求助专属客服

使用

限企业实名用户使用

本接口需提供应用场景审核

个人实名用户无法使用

API资讯

0.多模型路由与故障转移指南

数据驱动未来

Data Drives The Future

立即注册

找API接口，上API数据！

viduq3-turbo

使用文档

附件资料

计费明细

推荐API

API资讯