视频生成 API

Authorization: Bearer 你的_API_KEY
Content-Type: application/json

{
  "references": {
    "image": "https://example.com/ref.jpg",
    "images": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"],
    "video": "https://example.com/ref.mp4",
    "videos": ["https://example.com/ref1.mp4", "https://example.com/ref2.mp4"],
    "audio": "https://example.com/ref.mp3",
    "audios": ["https://example.com/ref1.mp3", "https://example.com/ref2.mp3"]
  }
}

{
  "frames": {
    "first_frame": "https://example.com/start.jpg",
    "last_frame": "https://example.com/end.jpg"
  }
}

{
  "id": "task_abc123def456",
  "object": "video",
  "model": "ch0101-sd-2.0-720p",
  "status": "queued",
  "progress": 0,
  "created_at": 1790403391
}

{
  "id": "task_abc123def456",
  "object": "video",
  "model": "ch0101-sd-2.0-720p",
  "status": "completed",
  "progress": 100,
  "created_at": 1790403391,
  "completed_at": 1790403523
}

{
  "id": "task_abc123def456",
  "object": "video",
  "model": "ch0101-sd-2.0-720p",
  "status": "failed",
  "progress": 100,
  "created_at": 1790403391,
  "completed_at": 1790403523,
  "error": {
    "code": "video_generation_failed",
    "message": "失败原因描述"
  }
}

{
  "error": {
    "code": "invalid_params",
    "message": "具体错误描述",
    "type": "new_api_error"
  }
}

curl -X POST https://new.tangzhi.org/v1/videos \
  -H "Authorization: Bearer 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch0101-sd-2.0-720p",
    "prompt": "人物向前走，背景流动变换",
    "client_task_id": "order_20260926_000001",
    "mode": "references",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

curl -X POST https://new.tangzhi.org/v1/videos \
  -H "Authorization: Bearer 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch0101-sd-2.0-720p",
    "prompt": "让画面中的人物微笑并挥手",
    "client_task_id": "order_20260926_000002",
    "mode": "references",
    "duration": 5,
    "resolution": "720p",
    "references": { "image": "https://example.com/ref.jpg" }
  }'

curl -X POST https://new.tangzhi.org/v1/videos \
  -H "Authorization: Bearer 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch0101-sd-2.0-720p",
    "prompt": "镜头从白天平滑过渡到夜晚",
    "client_task_id": "order_20260926_000003",
    "mode": "frames",
    "duration": 5,
    "resolution": "720p",
    "frames": {
      "first_frame": "https://example.com/start.jpg",
      "last_frame": "https://example.com/end.jpg"
    }
  }'

curl https://new.tangzhi.org/v1/videos/task_abc123def456 \
  -H "Authorization: Bearer 你的_API_KEY"

curl -o output.mp4 https://new.tangzhi.org/v1/videos/task_abc123def456/content \
  -H "Authorization: Bearer 你的_API_KEY"

import time
import requests

BASE = "https://new.tangzhi.org"
HEADERS = {"Authorization": "Bearer sk-xxxxxxxxxxxxxxxx", "Content-Type": "application/json"}
CLIENT_TASK_ID = "order_20260926_000001"

# 1. 创建任务
resp = requests.post(f"{BASE}/v1/videos", headers=HEADERS, json={
    "model": "ch0101-sd-2.0-720p",
    "prompt": "人物向前走，背景流动变换",
    "client_task_id": CLIENT_TASK_ID,
    "mode": "references",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
}, timeout=120)
resp.raise_for_status()
task_id = resp.json()["id"]
print(f"任务已创建：{task_id}")

# 2. 轮询任务状态
while True:
    task = requests.get(f"{BASE}/v1/videos/{task_id}", headers=HEADERS, timeout=30).json()
    status = task["status"]
    print(f"状态: {status} ({task.get('progress', 0)}%)")
    if status in ("completed", "failed"):
        break
    time.sleep(10)

# 3. 下载视频
if task["status"] == "completed":
    video = requests.get(f"{BASE}/v1/videos/{task_id}/content", headers=HEADERS, timeout=300).content
    with open("output.mp4", "wb") as f:
        f.write(video)
    print("已保存 output.mp4")
else:
    print(f"失败: {task.get('error', {}).get('message', '未知原因')}")

const BASE = "https://new.tangzhi.org";
const headers = { Authorization: "Bearer sk-xxxxxxxxxxxxxxxx", "Content-Type": "application/json" };

const created = await fetch(`${BASE}/v1/videos`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "ch0101-sd-2.0-720p",
    prompt: "人物向前走，背景流动变换",
    client_task_id: "order_20260926_000001",
    mode: "references",
    duration: 5,
    resolution: "720p",
  }),
}).then((r) => r.json());

let task;
do {
  await new Promise((r) => setTimeout(r, 10000));
  task = await fetch(`${BASE}/v1/videos/${created.id}`, { headers }).then((r) => r.json());
  console.log(task.status, task.progress);
} while (!["completed", "failed"].includes(task.status));