Build the next frame.

Authorization: Bearer sk-YOUR_TOKEN

curl https://api.kino-api.com/v1/video/generations \
  -H "Authorization: Bearer $KINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "A quiet ocean at dawn, cinematic light",
  "duration": 4,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9"
  }
}'

{
  "task_id": "task_EXAMPLE",
  "status": "queued",
  "model": "seedance-2.5"
}

curl https://api.kino-api.com/v1/video/generations/task_EXAMPLE -H "Authorization: Bearer $KINO_API_KEY"

{
  "data": {
    "status": "SUCCESS",
    "result_url": "https://media.uptoken.cc/example.mp4",
    "quota": 12345
  }
}

{
  "model": "seedance-2.5",
  "prompt": "The camera slowly approaches the scene",
  "duration": 4,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://YOUR_HOST/reference.jpg"
        },
        "role": "reference_image"
      }
    ]
  }
}

{
  "model": "seedance-2.5-video",
  "prompt": "Keep the motion and reimagine the light",
  "metadata": {
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": -1,
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://YOUR_HOST/reference.mp4"
        },
        "role": "reference_video"
      }
    ]
  }
}

{
  "model": "seedream-5.0-pro",
  "prompt": "A sculptural amber glass bottle on volcanic stone",
  "size": "2K",
  "watermark": false
}

{
  "created": 1789000000,
  "data": [
    {
      "url": "https://media.uptoken.cc/example.jpg"
    }
  ]
}

const BASE = "https://api.kino-api.com";
const key = process.env.KINO_API_KEY;
if (!key) throw new Error("Set KINO_API_KEY on the server");
const headers = {
  Authorization: `Bearer ${key}`,
  "Content-Type": "application/json"
};
async function api(path, options = {}) {
  const response = await fetch(BASE + path, {
    ...options, headers, signal: AbortSignal.timeout(240_000)
  });
  const body = await response.json();
  if (!response.ok || body.error) {
    throw new Error(body.error?.message || `HTTP ${response.status}`);
  }
  return body.data ?? body;
}
// Submit ONCE. A timeout is not proof of failure; do not auto-retry.
const created = await api("/v1/video/generations", {
  method: "POST",
  body: JSON.stringify({
    model: "seedance-2.5",
    prompt: "A quiet ocean at dawn, cinematic light",
    duration: 4,
    metadata: { resolution: "720p", ratio: "16:9" }
  })
});
const id = created.task_id ?? created.id;
if (!id) throw new Error("Missing task ID; check your task log");
console.log("Save this task ID:", id);
const deadline = Date.now() + 20 * 60_000;
let completed = false;
while (Date.now() < deadline) {
  await new Promise(resolve => setTimeout(resolve, 5000));
  const task = await api(`/v1/video/generations/${encodeURIComponent(id)}`);
  const status = String(task.status).toLowerCase();
  if (["success", "completed", "succeeded"].includes(status)) {
    console.log("Download promptly:", task.result_url ?? task.url);
    completed = true;
    break;
  }
  if (["failure", "failed", "cancelled"].includes(status)) {
    throw new Error(task.fail_reason || "Generation failed");
  }
}
if (!completed) console.log("Still pending. Resume polling this ID:", id);