Video and images,
from one API key.

curl

# 1. List the models your key may use
curl https://popcornstudio.ai/api/v1/models \
  -H "Authorization: Bearer $POPCORN_API_KEY"

# 2. Start a generation
curl https://popcornstudio.ai/api/v1/generations \
  -H "Authorization: Bearer $POPCORN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"<model id>","params":{"prompt":"A paper boat drifting down a rainy street at dusk"}}'

# 3. Poll every 10 s until the status is final
curl https://popcornstudio.ai/api/v1/generations/job_... \
  -H "Authorization: Bearer $POPCORN_API_KEY"

Node.js

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

const base = "https://popcornstudio.ai/api/v1";
const headers = { Authorization: `Bearer ${process.env.POPCORN_API_KEY}`, "Content-Type": "application/json" };

const res = await fetch(`${base}/generations`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": randomUUID() },
  body: JSON.stringify({
    "model": "<model id>",
    "params": {
      "prompt": "A paper boat drifting down a rainy street at dusk"
    }
  }),
});
let job = await res.json();
if (!res.ok) throw new Error(`${job.code}: ${job.error}`);

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 10000));
  job = await (await fetch(`${base}/generations/${job.id}`, { headers })).json();
}
console.log(job.status, job.outputs.map((o) => o.url), job.error);