可灵 3.0 视频生成 API

curl -X POST "https://api.looprouter.com/text-to-video/kling-3.0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "prompt": "一只柯基犬在草地上奔跑，阳光明媚，慢镜头",
    "settings": {
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "duration": 5,
      "audio": "native",
      "multi_shot": true
    }
  }'

# 返回：{"code":0,"message":"SUCCEED","request_id":"...","data":{"id":"task_xxxx","status":"submitted","create_time":1781080778802,"update_time":1781080778802}}

import time
import requests

BASE = "https://api.looprouter.com"
HEADERS = {"Authorization": "Bearer sk-你的APIKey"}

# 1. 创建任务
resp = requests.post(
    f"{BASE}/text-to-video/kling-3.0",
    headers=HEADERS,
    json={
        "prompt": "一只柯基犬在草地上奔跑，阳光明媚，慢镜头",
        "settings": {
            "resolution": "1080p",
            "aspect_ratio": "16:9",
            "duration": 5,
            "audio": "native",
        },
    },
)
resp.raise_for_status()
task_id = resp.json()["data"]["id"]
print("任务已创建:", task_id)

# 2. 轮询任务状态（建议 10 秒一次）
while True:
    data = requests.get(
        f"{BASE}/tasks",
        headers=HEADERS,
        params={"task_ids": task_id},
    ).json()["data"]
    task = data[0]
    status = task["status"]
    print("当前状态:", status)
    if status in ("succeeded", "failed"):
        break
    time.sleep(10)

# 3. 下载成片（下载时不要携带 Authorization 头）
if status == "succeeded":
    video_url = task["outputs"][0]["url"]
    with requests.get(video_url, stream=True) as r:
        r.raise_for_status()
        with open("output.mp4", "wb") as f:
            for chunk in r.iter_content(chunk_size=1 << 20):
                f.write(chunk)
    print("已保存 output.mp4")
else:
    print("任务失败:", task_id)

// POST /image-to-video/kling-3.0
// 首帧：contents 放 1 张 first_frame；首尾帧：再加 1 张 last_frame
{
  "prompt": "镜头缓缓推进，人物转身微笑，从清晨过渡到黄昏",
  "settings": {
    "resolution": "1080p",
    "duration": 5,
    "audio": "native"
  },
  "contents": [
    { "type": "first_frame", "url": "https://example.com/first.jpg" },
    { "type": "last_frame", "url": "https://example.com/last.jpg" }
  ]
}

// POST /omni-video/kling-3.0-omni
// contents 里放 refer_image / feature_video / base_video / element 等素材，
// 网关按顺序自动把素材绑定进提示词，无需手写占位符。
{
  "prompt": "让参考图中的角色在城市夜景中行走，参考该视频的运镜与节奏",
  "settings": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio": "original"
  },
  "options": {
    "external_task_id": "my-biz-001"
  },
  "contents": [
    { "type": "refer_image", "url": "https://example.com/character.jpg" },
    { "type": "feature_video", "url": "https://example.com/motion.mp4" }
  ]
}

curl -X POST "https://api.looprouter.com/motion-control/kling-3.0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "contents": [
      { "type": "image", "url": "https://example.com/char.png" },
      { "type": "video", "url": "https://example.com/drive.mp4" },
      { "type": "prompt", "text": "the character dances energetically" }
    ],
    "settings": {
      "character_orientation": "video",
      "audio": "original",
      "resolution": "720p"
    }
  }'

curl -X POST "https://api.looprouter.com/videos/motion-control" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "prompt": "the character dances energetically",
    "image_url": "https://example.com/char.png",
    "video_url": "https://example.com/drive.mp4",
    "mode": "std",
    "character_orientation": "video",
    "keep_original_sound": "yes",
    "watermark_info": { "enabled": false }
  }'