API Documentation

https://api.ultimatecreator.ai/v1

curl --fail-with-body --max-time 30 -X POST https://api.ultimatecreator.ai/v1/video/generate \
  -H "Authorization: Bearer $UC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 746524ce-17c0-470a-9439-480093bf40b5" \
  -d '{
    "prompt": "A tech CEO delivering a keynote on stage",
    "target_length_seconds": 30,
    "max_credits": 150,
    "webhook_url": "https://your-server.example/webhooks/video",
    "idempotency_key": "746524ce-17c0-470a-9439-480093bf40b5"
  }'

{
  "job_id": "job_01HXYZ",
  "status": "succeeded",
  "created_at": "2026-09-06T12:00:00Z",
  "completed_at": "2026-09-06T12:04:12Z",
  "video_url": "https://storage.googleapis.com/example/video.mp4?signature=example",
  "error_message": null,
  "placeholder_warning": null,
  "lipsync_status": null,
  "c2pa": {
    "synthid": false,
    "manifest_present": false,
    "last_verified": null
  },
  "quality_scores": null,
  "avatar_id": null
}

{
  "job_id": "job_01HXYZ",
  "status": "completed",
  "download_url": "https://storage.googleapis.com/example/video.mp4?signature=example"
}

import { setTimeout as sleep } from "node:timers/promises";

const API_BASE = "https://api.ultimatecreator.ai/v1";
const API_KEY = process.env.UC_API_KEY;
const WEBHOOK_URL = process.env.UC_WEBHOOK_URL;
const IDEMPOTENCY_KEY = process.env.UC_IDEMPOTENCY_KEY;
if (!API_KEY || !WEBHOOK_URL || !IDEMPOTENCY_KEY) {
  throw new Error("Set UC_API_KEY, UC_WEBHOOK_URL, and UC_IDEMPOTENCY_KEY");
}
if (new URL(WEBHOOK_URL).protocol !== "https:") {
  throw new Error("UC_WEBHOOK_URL must be your public HTTPS endpoint");
}
const headers = { Authorization: `Bearer ${API_KEY}` };

async function generateVideo() {
  const createRes = await fetch(`${API_BASE}/video/generate`, {
    method: "POST",
    redirect: "error",
    signal: AbortSignal.timeout(30_000),
    headers: {
      ...headers,
      "Content-Type": "application/json",
      "Idempotency-Key": IDEMPOTENCY_KEY,
    },
    body: JSON.stringify({
      prompt: "A tech CEO delivering a keynote on stage",
      target_length_seconds: 30,
      max_credits: 150, // Replace with the credit ceiling you approved after quoting.
      webhook_url: WEBHOOK_URL,
      aspect_ratio: "16:9",
      idempotency_key: IDEMPOTENCY_KEY,
    }),
  });
  if (createRes.status !== 202) {
    throw new Error(`Submit HTTP ${createRes.status}: ${await createRes.text()}`);
  }
  const { job_id } = await createRes.json();
  if (typeof job_id !== "string" || !job_id) throw new Error("Missing job_id");
  console.log("Job created:", job_id);

  for (let attempt = 0; attempt < 60; attempt++) {
    await sleep(15_000);
    const response = await fetch(
      `${API_BASE}/video/jobs/${encodeURIComponent(job_id)}`,
      { headers, redirect: "error", signal: AbortSignal.timeout(30_000) }
    );
    if (!response.ok) {
      throw new Error(`Poll HTTP ${response.status}: ${await response.text()}`);
    }
    const job = await response.json();
    console.log("Status:", job.status);
    if (job.status === "succeeded" || job.status === "completed") {
      if (!job.video_url) throw new Error("Job finished without a video URL; reconcile this job later");
      console.log("Video URL:", job.video_url);
      if (job.placeholder_warning) console.warn(job.placeholder_warning);
      return job;
    }
    if (["failed", "degraded", "canceled", "refunded", "flagged"].includes(job.status)) {
      throw new Error(`Job ${job_id}: ${job.status} — ${job.error_message ?? job.placeholder_warning ?? "inspect job details"}`);
    }
  }
  throw new Error(`Polling limit reached for ${job_id}; resume checking this job, do not resubmit`);
}

generateVideo().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

# pip install requests
import os
import time
from urllib.parse import quote, urlparse
import requests

API_BASE = "https://api.ultimatecreator.ai/v1"
API_KEY = os.environ["UC_API_KEY"]
WEBHOOK_URL = os.environ["UC_WEBHOOK_URL"]
IDEMPOTENCY_KEY = os.environ["UC_IDEMPOTENCY_KEY"]
if not API_KEY or not IDEMPOTENCY_KEY:
    raise ValueError("Set UC_API_KEY and UC_IDEMPOTENCY_KEY")
if urlparse(WEBHOOK_URL).scheme != "https" or not urlparse(WEBHOOK_URL).hostname:
    raise ValueError("UC_WEBHOOK_URL must be your public HTTPS endpoint")
headers = {"Authorization": f"Bearer {API_KEY}"}


def generate_video():
    create_res = requests.post(
        f"{API_BASE}/video/generate",
        headers={**headers, "Idempotency-Key": IDEMPOTENCY_KEY},
        json={
            "prompt": "A tech CEO delivering a keynote on stage",
            "target_length_seconds": 30,
            "max_credits": 150,  # Replace with the credit ceiling approved after quoting.
            "webhook_url": WEBHOOK_URL,
            "aspect_ratio": "16:9",
            "idempotency_key": IDEMPOTENCY_KEY,
        },
        timeout=30,
        allow_redirects=False,
    )
    if create_res.status_code != 202:
        raise RuntimeError(f"Submit HTTP {create_res.status_code}: {create_res.text}")
    job_id = create_res.json()["job_id"]
    if not isinstance(job_id, str) or not job_id:
        raise RuntimeError("Missing job_id")
    print("Job created:", job_id)

    unsuccessful = {"failed", "degraded", "canceled", "refunded", "flagged"}
    for _ in range(60):
        time.sleep(15)
        response = requests.get(
            f"{API_BASE}/video/jobs/{quote(job_id, safe='')}",
            headers=headers,
            timeout=30,
            allow_redirects=False,
        )
        if not 200 <= response.status_code < 300:
            raise RuntimeError(f"Poll HTTP {response.status_code}: {response.text}")
        job = response.json()
        status = job["status"]
        print("Status:", status)
        if status in ("succeeded", "completed"):
            if not job.get("video_url"):
                raise RuntimeError("Job finished without a video URL; reconcile this job later")
            print("Video URL:", job["video_url"])
            if job.get("placeholder_warning"):
                print("Warning:", job["placeholder_warning"])
            return job
        if status in unsuccessful:
            reason = job.get("error_message") or job.get("placeholder_warning") or "inspect job details"
            raise RuntimeError(f"Job {job_id}: {status} — {reason}")
    raise TimeoutError(f"Polling limit reached for {job_id}; resume checking this job, do not resubmit")


if __name__ == "__main__":
    generate_video()

{
  "error": "Rate limit exceeded",
  "detail": "Maximum 100 requests per 60s. Retry after 60s.",
  "code": "RATE_LIMITED"
}