生视频per_second

Vidu Q3 Pro

viduq3-pro

Vidu Q3 专业版。通过小乖 API 以统一的 Bearer Key 异步调用，提交后返回 task_id，轮询即可获取视频地址。适合短视频、广告试片与自动化管线。模型 ID：viduq3-pro。

API 文档 →获取 API Key 全部定价

售价 // PRICE

¥0.45/秒

人民币余额扣费。提交任务时冻结，成功结算；失败/超时自动退款。实际金额以任务结算为准。

▸ 异步任务

▸ 失败自动退款

▸ 文生/图生视频

▸ 按秒透明计价

▸ 人民币余额

▸ 统一 API Key

参数说明 // PARAMETERS

必填：model、prompt。下列为可选参数（提交时未知字段会被拒绝）。

参数	说明	取值
duration	时长（秒）视频时长；按秒计费的模型最终金额 = 售价 × 秒数。	整数 1–16，默认 5
resolution	分辨率影响清晰度与计费（部分模型按更高分辨率计价）。	可选：540p / 720p / 1080p
aspect_ratio	画面比例横屏 / 竖屏 / 方形。	可选：16:9 / 9:16 / 1:1
image_urls	参考图 URL 可选参考图，支持 https URL 或 base64 Data URI。	URL 数组，最多 1 个

快速接入 // QUICKSTART

cURL

curl -X POST https://xiaoguai123.xyz/api/v1/videos/generations \
  -H "Authorization: Bearer cr_你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "viduq3-pro", "prompt": "镜头缓缓推进，瀑布与彩虹，自然光", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9"}'

# → { "code":200, "data":[{ "status":"submitted", "task_id":"xg_..." }] }
# 再轮询 GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

Python

import requests, time

BASE = "https://xiaoguai123.xyz"
KEY = "cr_你的Key"
H = {"Authorization": f"Bearer {KEY}"}
payload = {
  "model": "viduq3-pro",
  "prompt": "镜头缓缓推进，瀑布与彩虹，自然光",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

r = requests.post(f"{BASE}/api/v1/videos/generations", headers={**H, "Content-Type": "application/json"}, json=payload)
r.raise_for_status()
task_id = r.json()["data"][0]["task_id"]
print("task:", task_id)

while True:
    t = requests.get(f"{BASE}/api/v1/tasks/{task_id}", headers=H).json()["data"]
    print(t["status"], t.get("progress"))
    if t["status"] in ("completed", "failed"):
        print(t)
        break
    time.sleep(3)

适用场景 // USE CASES

短视频与广告

批量生成横竖屏素材，快速试片与投放变体。

产品演示

把静态产品图做成动态演示，降低拍摄成本。

故事板 / 前期

用文案直接出镜头，加速剧本可视化。

Agent 管线

在自动化工作流中按需提交任务并轮询结果。

常见问题 // FAQ

Q. 如何调用 Vidu Q3 Pro？

在控制台创建 API Key，向 POST /api/v1/videos/generations 提交，model 填 `viduq3-pro`，再轮询 GET /api/v1/tasks/{task_id} 获取结果。

Q. 怎么计费？失败会扣钱吗？

本模型按视频秒数计费。提交时先冻结金额，成功结算；失败或超时会自动解冻退回，不会吞余额。

Q. 和官方 API 有什么区别？

你使用小乖签发的 Key，人民币余额按任务扣费；上游 Key 由平台持有。接口形态对齐常见异步生图/生视频流程，方便接入。

Q. 支持参考图吗？

若参数表含 image_urls，可做图生视频；具体上限见参数说明。