Video Generation and Material Library API

# China region, accelerated route; China international route is https://global.inf.space, Global region is https://ai.inf.space
export BASE_URL="https://cn.inf.space"

# 1. Create a task (a public image used directly as a reference)
curl -X POST "$BASE_URL/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $INFERENCE_SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A natural, cinematic running shot with a stable camera; no subtitles or watermark"},
      {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'
# → {"id": "cgt-20260731120000-example", ...}

# 2. Poll until status is succeeded or failed (every 5–10 seconds)
curl "$BASE_URL/api/v3/contents/generations/tasks/cgt-20260731120000-example" \
  -H "Authorization: Bearer $INFERENCE_SPACE_API_KEY"

# 3. On success, download content.video_url
curl -L "$VIDEO_URL" -o output.mp4

[
  {"type": "text", "text": "The person runs from the left side of the frame to the right"},
  {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/first.jpg"}},
  {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/last.jpg"}},
  {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/ref.mp4"}}
]

{"id": "cgt-20260731120000-example"}

{
  "id": "cgt-20260731120000-example",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://...",
    "last_frame_url": "https://..."
  },
  "usage": {"completion_tokens": 100858, "total_tokens": 100858},
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "created_at": 1782208997,
  "updated_at": 1782209105
}

# China region, accelerated route; China international route is https://global.inf.space, Global region is https://ai.inf.space
curl -X POST "https://cn.inf.space/api/material?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Authorization: Bearer $INFERENCE_SPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Name": "product-references", "Description": "product reference assets"}'

{"type": "image_url", "role": "reference_image", "image_url": {"url": "asset://asset-20260623180317-8sxkd"}}

{
  "ResponseMetadata": {"RequestId": "2026062317822087486485654725234569", "Action": "CreateAssetGroup", "Version": "2024-01-01"},
  "Result": {"Id": "group-20260623180314-r2rc7"}
}

import os
import time

import requests

# China region, accelerated route; China international route is https://global.inf.space, Global region is https://ai.inf.space
BASE_URL = os.getenv("INFERENCE_SPACE_BASE_URL", "https://cn.inf.space")
MODEL = os.getenv("INFERENCE_SPACE_VIDEO_MODEL", "doubao-seedance-2-0-260128")
HEADERS = {"Authorization": f"Bearer {os.environ['INFERENCE_SPACE_API_KEY']}"}


def material(action, payload=None):
    r = requests.post(
        f"{BASE_URL}/api/material",
        params={"Action": action, "Version": "2024-01-01"},
        headers=HEADERS, json=payload or {}, timeout=30,
    )
    r.raise_for_status()
    result = r.json().get("Result") or {}
    if (result.get("Error") or {}).get("Code"):
        raise RuntimeError(f"{action} failed: {result['Error']}")
    return result


def poll(fetch, done, failed, timeout=900, interval=5):
    deadline = time.monotonic() + timeout
    while time.monotonic() < deadline:
        item = fetch()
        if done(item):
            return item
        if failed(item):
            raise RuntimeError(item)
        time.sleep(interval)
    raise TimeoutError("polling timed out")


def main():
    group = material("CreateAssetGroup", {"Name": "person-references", "Model": MODEL})
    asset = material("CreateAsset", {
        "GroupId": group["Id"],
        "Model": MODEL,
        "AssetType": "Image",
        "URL": os.environ["PERSON_IMAGE_URL"],
    })
    poll(lambda: material("GetAsset", {"Id": asset["Id"]}),
         done=lambda a: a.get("Status") == "Active",
         failed=lambda a: a.get("Status") == "Failed")

    r = requests.post(
        f"{BASE_URL}/api/v3/contents/generations/tasks",
        headers=HEADERS, timeout=30,
        json={
            "model": MODEL,
            "content": [
                {"type": "text", "text": "A stable running shot in natural light; no subtitles"},
                {"type": "image_url", "role": "reference_image",
                 "image_url": {"url": f"asset://{asset['Id']}"}},
            ],
            "resolution": "720p",
            "ratio": "16:9",
            "duration": 5,
            "watermark": False,
        },
    )
    r.raise_for_status()
    task_id = r.json()["id"]

    def get_task():
        resp = requests.get(f"{BASE_URL}/api/v3/contents/generations/tasks/{task_id}",
                            headers=HEADERS, timeout=30)
        resp.raise_for_status()
        return resp.json()

    task = poll(get_task,
                done=lambda t: t.get("status") == "succeeded",
                failed=lambda t: t.get("status") == "failed")
    print(task["content"]["video_url"])


if __name__ == "__main__":
    main()