Vidu 文生视频 API 文档

根据文本提示词生成视频。

官方参数详见 Vidu 官方文档。

服务商支持

渠道	说明
Vidu 官方	默认

创建任务

网络协议	请求地址	请求方法	请求格式	响应格式
https	/videos/vidu/text2video	POST	application/json	application/json

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Bearer	aiping 平台鉴权

请求体参数

参数名	类型	必填	说明
model	string	是	基础型号，如 viduq3-pro、viduq2
prompt	string	是	文本提示词，≤5000 字符
style	string	否	general / anime（q2/q3 不生效）
duration	int	否	时长，依模型而定
aspect_ratio	string	否	默认 16:9
resolution	string	否	如 540p、720p、1080p
movement_amplitude	string	否	auto / small / medium / large
bgm	bool	否	是否加 BGM
audio	bool	否	是否音视频直出（q3 系列）
seed	int	否	随机种子
off_peak	bool	否	错峰模式
watermark	bool	否	是否水印
callback_url	string	否	回调；不传时官方由 proxy 注入
payload	string	否	透传
extra_body.provider	object	否	路由，见 路由策略

查询任务（标准异步）

提交后使用 task-query.md 中的统一查询接口：

网络协议	请求地址	请求方法
https	/videos/vidu/tasks/{task_id}/creations	GET

响应为 Vidu 官方 creations 形态（state、creations[].url、credits 等）。

请求示例

{
  "model": "viduq3-pro",
  "prompt": "未来感展厅中，一台银色机器人缓慢走向镜头，灯光从蓝色切换为暖白色",
  "style": "general",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "bgm": false,
  "audio": false,
  "seed": 0,
  "off_peak": false,
  "watermark": false,
  "payload": "test-vidu-text2video-full",
  "extra_body": {
    "provider": { "only": ["Vidu"] }
  }
}

返回结构示例

{
  "task_id": "string",
  "state": "created",
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "未来感展厅中，一台银色机器人缓慢走向镜头，灯光从蓝色切换为暖白色",
  "duration": 5,
  "seed": 123456,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "test-vidu-text2video-full",
  "off_peak": false,
  "watermark": false,
  "credits": 0,
  "created_at": "2025-01-01T00:00:00Z",
  "aiping_id": "string"
}

注意事项

1. 参数取值范围、模型能力详见 Vidu 官方文档。
2. ViduQ2 错峰价格为正常生成价格的一半；如果积分存在小数，则向上取整。
3. 积分与人民币换算比例为：1 积分 = 0.03125 元。