视频生成

视频生成是异步的，分三步：创建任务 → 轮询状态 → 下载内容。

完整示例

import time, requests

BASE = "https://api.modelsite.ai/v1"
H = {"Authorization": "Bearer ms_live_sk_xxx", "Content-Type": "application/json"}

# 1. 创建任务
job = requests.post(f"{BASE}/videos/generations", headers=H, json={
"model": "wan2.5-t2v-preview",
"prompt": "A cat playing piano on a rooftop at sunset",
"seconds": 5,
"size": "1280x720",
}).json()
video_id = job["id"]

# 2. 轮询
while True:
v = requests.get(f"{BASE}/videos/{video_id}", headers=H).json()
if v["status"] in ("completed", "failed"):
    break
time.sleep(5)

if v["status"] == "failed":
raise RuntimeError(v["error"]["message"])

# 3. 下载
mp4 = requests.get(f"{BASE}/videos/{video_id}/content", headers=H).content
open("out.mp4", "wb").write(mp4)

下面的接口卡片由 OpenAPI 规范自动渲染（Request body 参数表、Response schema）。

curl -X POST "https://example.com/videos/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string"  }'

{  "id": "string",  "object": "video",  "status": "processing",  "model": "string",  "seconds": 0,  "created_at": 0,  "completed_at": 0,  "output_url": "string",  "usage": {    "completion_tokens": 0,    "total_tokens": 0  },  "error": {    "code": "string",    "message": "string"  },  "vendor_data": {}}

curl -X GET "https://example.com/videos/video_ual7J0gEbKHcrUcqI7nV7wkR6_V57Y_vlasce6jMjWOSfTKbgVcoIhA5"

{  "id": "string",  "object": "video",  "status": "processing",  "model": "string",  "seconds": 0,  "created_at": 0,  "completed_at": 0,  "output_url": "string",  "usage": {    "completion_tokens": 0,    "total_tokens": 0  },  "error": {    "code": "string",    "message": "string"  },  "vendor_data": {}}

curl -X GET "https://example.com/videos/string/content"

"string"

原厂参数完全兼容

上表的标准字段只是跨厂商的公共子集。上游厂商接受的任何参数，都可以按原厂参数名直接写在请求体顶层，原样透传，不需要任何包装、也不需要等平台加字段支持。

{
  "model": "veo-3.0-generate-001",
  "prompt": "A cat playing piano",
  "seconds": 8,
  "sampleCount": 2,
  "personGeneration": "dont_allow",
  "storageUri": "gs://my-bucket/output/"
}

三条规则：

• 原生参数名优先。同时传标准字段和原生字段时，原生字段胜出。例如 {"seconds": 8, "durationSeconds": 4} 发给上游的是 4 —— 你写原生参数就是要精确控制，翻译层让位。
• 每个模型只接受自己厂商的参数。传了属于其他厂商的参数会被拒绝并返回 400 —— 例如给 DashScope（wan）模型传 Seedance 的 camera_fixed、或给 Veo 模型传 Sora 的 n_seconds。请按你实际调用的模型所属厂商查阅下方参数。跨厂商通用的参数（duration、seed、size、resolution、negative_prompt 等）不受此限制。
• 嵌套结构递归合并。如 Nova Reel 的 videoGenerationConfig: {"fps": 30} 会与标准字段翻译出的 durationSeconds / dimension 合并，而不是整体覆盖。

响应侧同样零损耗：上游返回的所有非标准字段都保留在 vendor_data 里，包括本文档尚未收录的新字段。

各厂商原生参数名要点

同一个概念在各厂商的参数名和类型经常不同。用标准字段时平台自动翻译；写原生参数时必须用下表的原厂名字。

常用原生参数

Vertex AI Veo（进入请求的 parameters 对象）：

instance 级原生字段（last_frame、input_video、mask、mask_mode、reference_images）会正确写进 Veo 的 instances，不会误落到 parameters。

ModelArk Seedance（合并到请求顶层）：

DashScope wan：input 级原生参数（media、template、reference_urls、first_frame_url、last_frame_url、audio_url 等）自动分流到请求的 input 对象，其余生成旋钮进 parameters —— 你只管写在顶层，平台负责落位。

图生视频与参考素材

两组字段用途不同，别混用：

{
  "model": "wan2.5-i2v-preview",
  "prompt": "The cat stands up and walks away",
  "seconds": 5,
  "frame_images": [
    { "image_url": "https://example.com/first.jpg", "frame_type": "first_frame" },
    { "image_url": "https://example.com/last.jpg", "frame_type": "last_frame" }
  ],
  "input_references": [
    { "type": "video", "url": "https://example.com/motion.mp4", "role": "reference_video" }
  ]
}

各厂商对参考素材的支持差异较大，不支持的厂商会静默忽略 input_references，不报错。

尺寸参数：三种写法

size、resolution + aspect_ratio 是等价的两种表达，选一种即可：

{ "size": "1280x720" }
{ "resolution": "720p", "aspect_ratio": "16:9" }

同时传且互相冲突时返回 400。别名 ratio（DashScope / ModelArk 的原生名）等同于 aspect_ratio。

计费

按视频时长计费：费用 = 时长（秒） × 该模型的每秒单价。时长取实际生成结果的秒数，任务失败不计费。单价见 模型页。

错误处理

status 为 failed 时读 error 对象：

{
  "id": "video_xxx",
  "object": "video",
  "status": "failed",
  "error": { "code": "content_policy_violation", "message": "..." }
}

常见失败原因：提示词触发内容审核、参考图片无法访问、请求的时长 / 尺寸组合该模型不支持。参数类错误在创建阶段就返回 400，不会进入异步流程。完整错误码见 错误处理。