视频生成模型

POST /v1/videos — 创建视频生成任务
GET /v1/videos/{video_id} — 查询单个任务
GET /v1/videos — 查询任务列表
DELETE /v1/videos/{video_id} — 取消任务

POST {CMR_BASE_URL}/v1/videos
GET  {CMR_BASE_URL}/v1/videos/{video_id}
GET  {CMR_BASE_URL}/v1/videos
DELETE {CMR_BASE_URL}/v1/videos/{video_id}

# ① 创建任务
curl --request POST "${CMR_BASE_URL}/v1/videos" \\
  --header "Authorization: Bearer ${CMR_API_KEY}" \\
  --header "Content-Type: application/json" \\
  --data '{
    "model": "kling-v3",
    "contents": [
      { "type": "text", "text": "一只橙色小猫在窗台上看向镜头，阳光洒在毛发上" }
    ],
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'
# → {"id":"video_abc123","error":null}

# ② 轮询任务状态，直到 status 为 completed 或 failed
curl --request GET "${CMR_BASE_URL}/v1/videos/video_abc123" \\
  --header "Authorization: Bearer ${CMR_API_KEY}"

# ③ status=completed 后，从 outputs[0].url 获取视频并尽快下载转存

import os
import time
import requests

base_url = os.environ["CMR_BASE_URL"]
headers = {
    "Authorization": f"Bearer {os.environ['CMR_API_KEY']}",
    "Content-Type": "application/json",
}

# ① 创建任务
resp = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    json={
        "model": "kling-v3",
        "contents": [
            {"type": "text", "text": "一只橙色小猫在窗台上看向镜头，阳光洒在毛发上"}
        ],
        "duration": 5,
        "resolution": "1080p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
resp.raise_for_status()
video_id = resp.json()["id"]

# ② 轮询任务状态（建议间隔 5 秒以上）
while True:
    task = requests.get(
        f"{base_url}/v1/videos/{video_id}",
        headers=headers,
        timeout=30,
    ).json()
    if task["status"] in ("completed", "failed", "expired"):
        break
    time.sleep(5)

# ③ 获取结果
if task["status"] == "completed":
    print(task["outputs"][0]["url"])   # 视频地址，请尽快下载转存
else:
    print(task["error"])

POST /v1/videos

{
  "model": "kling-v3",
  "contents": [
    { "type": "text", "text": "让画面中的主体自然转头，微风吹动头发" },
    { "type": "image", "role": "first_frame", "url": "https://example.com/start.jpg" }
  ],
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

{
  "model": "kling-3.0-omni",
  "contents": [
    { "type": "text", "text": "让画面主体自然转头" },
    { "type": "video", "role": "feature", "url": "https://example.com/clip.mp4" }
  ]
}

{
  "id": "video_abc123",
  "error": null
}

{
  "model": "doubao-seedance-2-5",
  "contents": [{ "type": "text", "text": "清晨的咖啡馆里，一杯咖啡冒着热气" }],
  "return_last_frame": true
}

GET /v1/videos/{video_id}

{
  "id": "video_abc123",
  "object": "video",
  "status": "completed",
  "created_at": 1787000000,
  "completed_at": 1787000300,
  "model": "kling-v3",
  "error": null,
  "outputs": [
    {
      "url": "https://example-cdn.com/output/abc123.mp4?sign=...",
      "cover_url": "https://example-cdn.com/output/abc123_cover.jpg?sign=...",
      "watermark_url": null,
      "last_frame_url": null
    }
  ],
  "usage": {
    "seconds": 5,
    "width": 1920,
    "height": 1080,
    "fps": 24,
    "tokens": null,
    "billing": null
  }
}

GET /v1/videos

DELETE /v1/videos/{video_id}