Wan3.0 专用接口文档（v1.7 · Wan3.0 专用）

RULESWan3.0 核心红线（先读这个）

AUTH认证与端点清单

所有请求携带请求头：Authorization: Bearer sk-rh-xxxxxxxx...（密钥在网页端「用户详情 → 中转站 API 密钥」）。限频 60 次/分钟，超限返回 429 + Retry-After。

MODE自主创作 free-video（纯文 / 图生视频）

POST /videosmode=free-video

POST /api/open/v1/videos
{
  "mode": "free-video",
  "model": "Wan3.0",
  "prompt": "黄色亚麻衬衫套装平铺展示，柔光，电商白底风格",
  "duration": 10,
  "aspect_ratio": "16:9",
  "images": ["https://my-cdn.com/product.jpg"],
  "audios": ["https://my-cdn.com/voiceover.mp3"]
}
# 201 返回：{ "job_id": "...", "status": "queued" }

POLL轮询查询与状态机

GET /videos/{job_id}GET /videos?status=&limit=

# 查询
GET /api/open/v1/videos/<job_id>
{ "job_id": "...", "status": "generating", "progress": 42 }

# Wan3.0 时长超限 → 400
{ "error": "Wan3.0 时长支持 2-30 的整数秒；更长的视频请改用 Seedance 2.0 系列（4-15 秒，成片固定 720P 竖屏）。",
  "code": "validation_error" }

CODEPython 全流程示例（提交 → 轮询 → 下载）

import os, time, urllib.request, json

BASE = "https://ultivox.cn/api/open/v1"
KEY = os.environ["ULTIVOX_API_KEY"]   # sk-rh-...

def call(path, payload=None, method=None):
    data = json.dumps(payload).encode() if payload is not None else None
    req = urllib.request.Request(
        BASE + path, data=data,
        method=method or ("POST" if data else "GET"),
        headers={"Authorization": "Bearer " + KEY, "Content-Type": "application/json"})
    return json.loads(urllib.request.urlopen(req).read())

# 1) 提交：Wan3.0，10 秒 480P（分辨率仅 480P 可用；duration 必须在 2~30 之间）
job = call("/videos", {
    "mode": "free-video", "model": "Wan3.0",
    "prompt": "产品在暖光厨房台面上，手持展示细节，电商质感",
    "duration": 10,
    "images": ["https://my-cdn.com/product.jpg"]})
print("job:", job["job_id"])

# 2) 轮询（每 10 秒；404 退避重试；5xx 继续等）
while True:
    time.sleep(10)
    try:
        st = call("/videos/" + job["job_id"])
    except Exception:
        continue
    print(st["status"], st.get("progress"))
    if st["status"] in ("succeeded", "failed"):
        break

# 3) 下载（video_url 6 小时有效，及时转存）
if st["status"] == "succeeded":
    urllib.request.urlretrieve(st["video_url"], "output.mp4")
else:
    print("failed:", st.get("error"))

ERRORSWan3.0 高频错误速查