生视频per_task
Veo 3.1 Quality
veo-3.1-quality
Google Veo 3.1 画质版。通过小乖 API 以统一的 Bearer Key 异步调用，提交后返回 task_id，轮询即可获取视频地址。适合短视频、广告试片与自动化管线。模型 ID：veo-3.1-quality。
售价 // PRICE
¥4.32 起/次
- 720p¥4.32/次
- 1080p¥5.40/次
按 resolution（或 quality）分档计费；视频再乘 duration。提交任务时冻结，成功结算；失败/超时自动退款。
▸ 异步任务
▸ 失败自动退款
▸ 文生/图生视频
▸ 按秒透明计价
▸ 人民币余额
▸ 统一 API Key
参数说明 // PARAMETERS
必填：model、prompt。下列为可选参数（提交时未知字段会被拒绝）。
| 参数 | 说明 | 取值 |
|---|---|---|
| resolution | 分辨率 影响清晰度与计费（部分模型按更高分辨率计价）。 | 可选：720p / 1080p |
| duration | 时长（秒） 视频时长；按秒计费的模型最终金额 = 售价 × 秒数。 | 可选：8 |
| aspect_ratio | 画面比例 横屏 / 竖屏 / 方形。 | 可选：16:9 / 9:16 |
| 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": "veo-3.1-quality", "prompt": "镜头缓缓推进，瀑布与彩虹，自然光", "duration": 8, "resolution": "1080p", "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": "veo-3.1-quality",
"prompt": "镜头缓缓推进，瀑布与彩虹，自然光",
"duration": 8,
"resolution": "1080p",
"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. 如何调用 Veo 3.1 Quality？
在控制台创建 API Key，向 POST /api/v1/videos/generations 提交，model 填 `veo-3.1-quality`，再轮询 GET /api/v1/tasks/{task_id} 获取结果。
Q. 怎么计费？失败会扣钱吗？
本模型按任务计费。提交时先冻结金额，成功结算；失败或超时会自动解冻退回，不会吞余额。
Q. 和官方 API 有什么区别？
你使用小乖签发的 Key，人民币余额按任务扣费；上游 Key 由平台持有。接口形态对齐常见异步生图/生视频流程，方便接入。
Q. 支持参考图吗？
若参数表含 image_urls，可做图生视频；具体上限见参数说明。