Quickstart

curl https://api.supercool.com/v1/messages \
  -H "Authorization: Bearer $SUPERCOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"message": "A 15 second vertical ad for my candle shop, warm and cozy"}'

import os
import uuid

import requests

API = "https://api.supercool.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SUPERCOOL_API_KEY']}"}

resp = requests.post(
    f"{API}/messages",
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={"message": "A 15 second vertical ad for my candle shop, warm and cozy"},
    timeout=60,
)
resp.raise_for_status()
msg = resp.json()
print(msg["id"], msg["status"], msg["reply"])

// Node 18+ (save as quickstart.mjs)
import { randomUUID } from "node:crypto";

const API = "https://api.supercool.com/v1";
const headers = { Authorization: `Bearer ${process.env.SUPERCOOL_API_KEY}` };

const res = await fetch(`${API}/messages`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": randomUUID() },
  body: JSON.stringify({ message: "A 15 second vertical ad for my candle shop, warm and cozy" }),
});
const msg = await res.json();
console.log(msg.id, msg.status, msg.reply);

curl "https://api.supercool.com/v1/messages/msg_3f9a1c2e7b8d4e5f6a7b8c9d?wait=30" \
  -H "Authorization: Bearer $SUPERCOOL_API_KEY"

while not msg["final"]:
    if msg.get("resume") == "add_credits":
        print("Out of credits: add some before", msg["resume_by"], "and the work resumes by itself.")
        break
    resp = requests.get(f"{API}/messages/{msg['id']}", headers=HEADERS, params={"wait": 30}, timeout=60)
    resp.raise_for_status()
    msg = resp.json()
    for job in msg["jobs"]:
        print(f"  {job['title']}: {job['status']}")

print("Finished:", msg["status"], msg["reason"] or "")

let current = msg;
while (!current.final && current.resume !== "add_credits") {
  const r = await fetch(`${API}/messages/${current.id}?wait=30`, { headers });
  current = await r.json();
  for (const job of current.jobs) console.log(`  ${job.title}: ${job.status}`);
}
console.log("Finished:", current.status, current.reason ?? "");

curl -L -o candle_ad.mp4 "https://api.supercool.sh/api/v1/files/s/eyJmIjoiNWQwYzNl..."

for f in msg["files"]:
    with requests.get(f["url"], stream=True, timeout=300) as r:
        r.raise_for_status()
        with open(f["name"], "wb") as out:
            for chunk in r.iter_content(chunk_size=1 << 20):
                out.write(chunk)
    print("Saved", f["name"])

import { writeFile } from "node:fs/promises";

for (const f of current.files) {
  const r = await fetch(f.url);
  if (!r.ok) throw new Error(`download failed: ${r.status}`);
  await writeFile(f.name, Buffer.from(await r.arrayBuffer()));
  console.log("Saved", f.name);
}