跳转到主要内容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "created_at": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.toapis.com/llms.txt

Use this file to discover all available pages before exploring further.

  • 异步任务接口，提交后返回任务 ID
  • 支持模型：viduq3-pro、viduq3-turbo、viduq3-mix、viduq3
  • viduq3-pro 和 viduq3-turbo 支持文生视频、图生视频、首尾帧
  • viduq3 和 viduq3-mix 用于参考图生成视频，需传入 image_urls
  • 支持 540p / 720p / 1080p，其中 viduq3-mix 仅支持 720p / 1080p
请传入公网可访问的图片 URL。不要在 image_urls 中直接传 base64 图片数据；本地图片请先使用 上传图片接口 获取 URL。

​
认证

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 认证。
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
必填
Vidu Q3 模型名称。可选值：
  • viduq3-pro - 高质量模型
  • viduq3-turbo - 快速模型
  • viduq3-mix - 多参考图生成视频
  • viduq3 - 多参考图生成视频
​
prompt
string
必填
视频提示词，描述主体、动作、场景、镜头和风格。示例："一只猫咪在弹钢琴，镜头缓缓推近，电影质感"
​
duration
integer
默认值:"5"
视频时长，单位秒。
  • viduq3-pro / viduq3-turbo：1 到 16
  • viduq3 / viduq3-mix：3 到 16
​
resolution
string
默认值:"720p"
视频分辨率。可选值：
  • 540p
  • 720p
  • 1080p
viduq3-mix 不支持 540p。
​
aspect_ratio
string
视频宽高比。文生视频时可用；传入 image_urls 时，宽高比通常由参考图片决定。常用值：16:9、9:16、1:1、4:3、3:4
​
image_urls
string[]
参考图片 URL 数组。
  • viduq3-pro / viduq3-turbo
    • 不传：文生视频
    • 传 1 张：图生视频，图片作为首帧
    • 传 2 张：首尾帧，第一张为首帧，第二张为尾帧
  • viduq3 / viduq3-mix
    • 必填，最多 7 张参考图片
示例：["https://example.com/reference.jpg"]
​
audio
boolean
默认值:"true"
是否生成音频。仅 viduq3-pro / viduq3-turbo 使用。默认值：true
​
metadata
object
扩展参数。
​
seed
integer
随机种子，用于在相同参数下复现相近结果。

​
模型选择

模型适用场景图片输入分辨率
viduq3-pro高质量文生/图生/首尾帧可选，最多 2 张540p / 720p / 1080p
viduq3-turbo快速文生/图生/首尾帧可选，最多 2 张540p / 720p / 1080p
viduq3-mix多参考图生成视频必填，最多 7 张720p / 1080p
viduq3多参考图生成视频必填，最多 7 张540p / 720p / 1080p

​
计费区分

Vidu Q3 按模型、分辨率和生成类型计费：
  • 普通生成：viduq3-pro、viduq3-turbo 不传 metadata.generation_type=reference2video
  • 参考生成：viduq3、viduq3-mix，或显式传 metadata.generation_type=reference2video

​
响应

​
id
string
任务 ID，用于查询任务状态。
​
object
string
对象类型，通常为 generation.task。
​
model
string
本次请求使用的模型名称。
​
status
string
任务状态：queued、in_progress、completed 或 failed。
​
created_at
integer
任务创建时间戳。

​
示例

​
文生视频

{
  "model": "viduq3-pro",
  "prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "audio": true
}

​
图生视频

{
  "model": "viduq3-turbo",
  "prompt": "让图片中的人物缓缓转身并微笑",
  "image_urls": ["https://example.com/portrait.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
首尾帧

{
  "model": "viduq3-pro",
  "prompt": "人物从站立自然坐下，动作流畅",
  "image_urls": [
    "https://example.com/first-frame.jpg",
    "https://example.com/last-frame.jpg"
  ],
  "duration": 8,
  "resolution": "720p"
}

​
多参考图生成视频

{
  "model": "viduq3-mix",
  "prompt": "保持参考图中的角色一致，在未来城市街道中行走",
  "image_urls": [
    "https://example.com/character-front.jpg",
    "https://example.com/character-side.jpg"
  ],
  "duration": 6,
  "resolution": "1080p",
  "metadata": {
    "generation_type": "reference2video"
  }
}
视频生成为异步任务。提交后使用 获取视频任务状态 查询进度和结果。
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'