视频（Videos）

{
  "id": "cgt-2026xxxx-xxxx"
}

{
  "id": "cgt-2026xxxx-xxxx",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../result.mp4"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1779348818,
  "updated_at": 1779348874,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "output_format": "mp4",
  "service_tier": "default",
  "execution_expires_after": 172800,
  "priority": 0
}

# Step 1：提交任务
curl -X POST https://api.tokgate.io/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      { "type": "text", "text": "清晨的海岸线，浪花拍打礁石，海鸥低空盘旋，镜头由远及近推进" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "output_format": "mp4",
    "watermark": false
  }'
# 响应: { "id": "cgt-2026xxxx-xxxx" }

# Step 2：轮询任务状态（建议间隔 15 秒）
curl https://api.tokgate.io/api/v3/contents/generations/tasks/cgt-2026xxxx-xxxx \
  -H "Authorization: Bearer sk-***"

# Step 3：status 变为 succeeded 后下载 content.video_url
curl -o coastline.mp4 "https://.../result.mp4"

curl -X POST https://api.tokgate.io/api/v3/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "seedance-2-0-fast",
    "content": [
      { "type": "text", "text": "以图片1为首帧，产品缓慢旋转展示细节，柔和棚拍光" },
      {
        "type": "image_url",
        "image_url": { "url": "https://your-cdn.example.com/product.jpg" },
        "role": "reference_image"
      }
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 5
  }'

{
  "model": "seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "第一人称视角的果茶广告：首帧为图片1，手摘下一颗带晨露的苹果；随后快切到雪克杯摇晃；尾帧定格为图片2。全程使用视频1的构图节奏，音频1作为背景音乐"
    },
    { "type": "image_url", "image_url": { "url": "https://your-cdn.example.com/pic1.jpg" }, "role": "reference_image" },
    { "type": "image_url", "image_url": { "url": "https://your-cdn.example.com/pic2.jpg" }, "role": "reference_image" },
    { "type": "video_url", "video_url": { "url": "https://your-cdn.example.com/ref.mp4" }, "role": "reference_video" },
    { "type": "audio_url", "audio_url": { "url": "https://your-cdn.example.com/bgm.mp3" }, "role": "reference_audio" }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 11,
  "watermark": false,
  "return_last_frame": true
}

{
  "model": "seedance-2-0",
  "content": [
    { "type": "text", "text": "拍一段介绍玻璃蛙外形特征的自然纪录片镜头，需符合真实生物特征" }
  ],
  "tools": [{ "type": "web_search" }],
  "ratio": "16:9",
  "duration": 11,
  "watermark": false
}

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

{
  "request_id": "99243b47-ec5f-9413-9993-xxxxxx",
  "output": {
    "task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-20 17:55:17.075",
    "scheduled_time": "2026-04-20 17:55:17.129",
    "end_time": "2026-04-20 17:56:36.658",
    "orig_prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机",
    "video_url": "https://.../result.mp4?Expires=..."
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9"
  }
}

{
  "request_id": "e5d70b02-ebd3-98ce-9fe8-xxxxxx",
  "output": {
    "task_id": "86ecf553-d340-4e21-af6e-xxxxxx",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The parameter is invalid."
  }
}

{
  "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
  "output": {
    "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
    "task_status": "UNKNOWN"
  }
}

# Step 1：只提交一次任务
curl -X POST https://api.tokgate.io/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {
      "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }'
# 保存响应中的 output.task_id，不要重新 POST

# Step 2：每 15 秒查询一次同一个 task_id
curl https://api.tokgate.io/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
  -H "Authorization: Bearer sk-***"

# Step 3：仅当 output.task_status 为 SUCCEEDED 时下载 output.video_url
curl -o happyhorse-result.mp4 "https://.../result.mp4?Expires=..."

curl -X POST https://api.tokgate.io/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {
      "prompt": "一只猫在草地上奔跑，阳光穿过草叶",
      "media": [
        { "type": "first_frame", "url": "https://your-cdn.example.com/cat.png" }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5
    }
  }'

curl -X POST https://api.tokgate.io/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "input": {
      "prompt": "[Image 1] 中身着红色旗袍的女性，轻抬手展开 [Image 2] 中的折扇，最后推近至面部特写",
      "media": [
        { "type": "reference_image", "url": "https://your-cdn.example.com/girl.jpg" },
        { "type": "reference_image", "url": "https://your-cdn.example.com/fan.jpg" }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

curl -X POST https://api.tokgate.io/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "input": {
      "prompt": "让视频中的角色穿上图片中的条纹毛衣，其余画面保持不变",
      "media": [
        { "type": "video", "url": "https://your-cdn.example.com/source.mp4" },
        { "type": "reference_image", "url": "https://your-cdn.example.com/sweater.webp" }
      ]
    },
    "parameters": {
      "resolution": "720P"
    }
  }'

import json
import os
import time
from pathlib import Path
from urllib.request import Request, urlopen

base_url = "https://api.tokgate.io"
api_key = os.environ["TOKGATE_API_KEY"]

payload = {
    "model": "happyhorse-1.1-t2v",
    "input": {
        "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机"
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}

# 只创建一次任务
create_request = Request(
    f"{base_url}/api/v1/services/aigc/video-generation/video-synthesis",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
        "X-DashScope-Async": "enable",
    },
    method="POST",
)
with urlopen(create_request, timeout=30) as response:
    created = json.load(response)

task_id = created["output"]["task_id"]
print(f"task_id={task_id}")

# 最多等待 30 分钟；PENDING / RUNNING 继续，任一终态停止
terminal_statuses = {"SUCCEEDED", "FAILED", "CANCELED", "UNKNOWN"}
for _ in range(120):
    time.sleep(15)
    query_request = Request(
        f"{base_url}/api/v1/tasks/{task_id}",
        headers={"Authorization": f"Bearer {api_key}"},
    )
    with urlopen(query_request, timeout=30) as response:
        result = json.load(response)

    output = result["output"]
    status = output["task_status"]
    print(f"task_status={status}")
    if status in terminal_statuses:
        break
else:
    raise TimeoutError("任务在 30 分钟内未进入终态")

if status != "SUCCEEDED":
    raise RuntimeError(
        f"{status}: {output.get('code', '')} {output.get('message', '')}"
    )

# 成功后立即下载；结果 URL 仅保留 24 小时
with urlopen(output["video_url"], timeout=180) as response:
    video = response.read()
if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("返回内容不是有效的 MP4 文件")

Path("happyhorse-result.mp4").write_bytes(video)
print(f"saved happyhorse-result.mp4 ({len(video)} bytes)")