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: Submit the task
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": "A coastline in the early morning, waves lapping against the reefs, seagulls circling low, the camera pushing in from far to near" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true,
    "output_format": "mp4",
    "watermark": false
  }'
# Response: { "id": "cgt-2026xxxx-xxxx" }

# Step 2: Poll the task status (recommended every 15 seconds)
curl https://api.tokgate.io/api/v3/contents/generations/tasks/cgt-2026xxxx-xxxx \
  -H "Authorization: Bearer sk-***"

# Step 3: Download content.video_url once status becomes succeeded
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": "Use image 1 as the first frame; the product rotates slowly to show details, soft studio lighting" },
      {
        "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": "A first-person-perspective fruit-tea commercial: the first frame is image 1 — a hand picks an apple covered in morning dew; then a quick cut to a shaker cup being shaken; the last frame freezes on image 2. Use the compositional rhythm of video 1 throughout, with audio 1 as the background music"
    },
    { "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": "Shoot a nature-documentary shot introducing the physical characteristics of the glass frog; it must match real biological traits" }
  ],
  "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": "A miniature city built from cardboard and bottle caps comes alive at night",
    "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: Create the task only once
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": "A miniature city built from cardboard and bottle caps comes alive at night. A cardboard train slowly passes by, with small lights illuminating the way."
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }'
# Save output.task_id from the response; do not POST again

# Step 2: Query the same task_id every 15 seconds
curl https://api.tokgate.io/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
  -H "Authorization: Bearer sk-***"

# Step 3: Download output.video_url only when output.task_status is SUCCEEDED
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": "A cat running across grass as sunlight filters through the blades",
      "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": "The woman in the red qipao from [Image 1] gently raises her hand to unfold the fan from [Image 2], ending with a close-up of her face",
      "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": "Put the character in the video into the striped sweater from the image; keep everything else unchanged",
      "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": "A miniature city built from cardboard and bottle caps comes alive at night"
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}

# Create the task only once
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}")

# Wait up to 30 minutes; continue on PENDING / RUNNING and stop on any terminal state
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("The task did not reach a terminal state within 30 minutes")

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

# Download immediately after success; the result URL is retained for only 24 hours
with urlopen(output["video_url"], timeout=180) as response:
    video = response.read()
if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("The response is not a valid MP4 file")

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