Generate your first video with the API.

#!/usr/bin/env bash
set -euo pipefail

: "${VIDIPROMPT_API_KEY:?Set VIDIPROMPT_API_KEY before running this script}"
BASE_URL="https://vidiprompt.com/api/v1"
IDEMPOTENCY_KEY="$(python3 -c 'import uuid; print(uuid.uuid4())')"

curl --fail-with-body --silent --show-error \
  --request POST "$BASE_URL/videos" \
  --header "Authorization: Bearer $VIDIPROMPT_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data @- \
  --dump-header response.headers \
  --output video.json <<'JSON'
{
  "topic": "The emperor who erased his own brother from history",
  "video_mode": "darkHistory",
  "style_pack": "documentary",
  "voice": "warm-storyteller",
  "language": "en",
  "captions": {
    "style": "tiktok",
    "position": "center"
  }
}
JSON

VIDEO_ID="$(python3 -c 'import json; print(json.load(open("video.json"))["id"])')"
VIDEO_URL="$(python3 -c 'import json; print(json.load(open("video.json"))["links"]["self"])')"
printf 'Created video %s\n' "$VIDEO_ID"

while true; do
  curl --fail-with-body --silent --show-error \
    --header "Authorization: Bearer $VIDIPROMPT_API_KEY" \
    --dump-header response.headers \
    --output video.json \
    "$VIDEO_URL"

  STATUS="$(python3 -c 'import json; print(json.load(open("video.json"))["status"])')"
  printf 'Status: %s\n' "$STATUS"

  case "$STATUS" in
    completed) break ;;
    queued|processing)
      RETRY_AFTER="$(python3 -c 'import re; data=open("response.headers").read(); match=re.search(r"(?im)^Retry-After:\s*(\d+)", data); print(match.group(1) if match else 5)')"
      sleep "$RETRY_AFTER"
      ;;
    *)
      printf 'Video ended with status %s. See video.json for details.\n' "$STATUS" >&2
      exit 1
      ;;
  esac
done

DOWNLOAD_URL="$(python3 -c 'import json; print(json.load(open("video.json"))["links"]["download"])')"
curl --fail-with-body --location --continue-at - \
  --header "Authorization: Bearer $VIDIPROMPT_API_KEY" \
  --output "$VIDEO_ID.mp4" \
  "$DOWNLOAD_URL"

printf 'Saved %s.mp4\n' "$VIDEO_ID"

import { randomUUID } from 'node:crypto';
import { writeFile } from 'node:fs/promises';

const apiKey = process.env.VIDIPROMPT_API_KEY;
if (!apiKey) throw new Error('Set VIDIPROMPT_API_KEY before running this script.');

const baseUrl = 'https://vidiprompt.com/api/v1';
const authHeaders = { Authorization: 'Bearer ' + apiKey };
const sleep = (seconds) => new Promise((resolve) => setTimeout(resolve, seconds * 1000));

async function readJson(response) {
  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.detail || data.title || 'VidiPrompt API request failed');
  }
  return data;
}

let response = await fetch(baseUrl + '/videos', {
  method: 'POST',
  headers: {
    ...authHeaders,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: JSON.stringify({
  "topic": "The emperor who erased his own brother from history",
  "video_mode": "darkHistory",
  "style_pack": "documentary",
  "voice": "warm-storyteller",
  "language": "en",
  "captions": {
    "style": "tiktok",
    "position": "center"
  }
}),
});

let video = await readJson(response);
let retryAfter = Number(response.headers.get('Retry-After') || 5);
console.log('Created video', video.id);

while (video.status === 'queued' || video.status === 'processing') {
  await sleep(retryAfter);
  response = await fetch(video.links.self, { headers: authHeaders });
  video = await readJson(response);
  retryAfter = Number(response.headers.get('Retry-After') || 5);
  console.log('Status:', video.status);
}

if (video.status !== 'completed' || !video.links.download) {
  throw new Error('Video ended with status ' + video.status + '.');
}

const download = await fetch(video.links.download, { headers: authHeaders });
if (!download.ok) throw new Error('Download failed with HTTP ' + download.status + '.');
await writeFile(video.id + '.mp4', Buffer.from(await download.arrayBuffer()));
console.log('Saved', video.id + '.mp4');

import os
import time
import uuid
from pathlib import Path

import requests

api_key = os.environ.get("VIDIPROMPT_API_KEY")
if not api_key:
    raise RuntimeError("Set VIDIPROMPT_API_KEY before running this script.")

base_url = "https://vidiprompt.com/api/v1"
auth_headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/videos",
    headers={
        **auth_headers,
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
  "topic": "The emperor who erased his own brother from history",
  "video_mode": "darkHistory",
  "style_pack": "documentary",
  "voice": "warm-storyteller",
  "language": "en",
  "captions": {
    "style": "tiktok",
    "position": "center"
  }
},
    timeout=30,
)
response.raise_for_status()
video = response.json()
retry_after = int(response.headers.get("Retry-After", "5"))
print("Created video", video["id"])

while video["status"] in {"queued", "processing"}:
    time.sleep(retry_after)
    response = requests.get(video["links"]["self"], headers=auth_headers, timeout=30)
    response.raise_for_status()
    video = response.json()
    retry_after = int(response.headers.get("Retry-After", "5"))
    print("Status:", video["status"])

if video["status"] != "completed" or not video["links"].get("download"):
    raise RuntimeError(f"Video ended with status {video['status']}.")

output = Path(f"{video['id']}.mp4")
with requests.get(video["links"]["download"], headers=auth_headers, stream=True, timeout=60) as download:
    download.raise_for_status()
    with output.open("wb") as file:
        for chunk in download.iter_content(chunk_size=1024 * 1024):
            if chunk:
                file.write(chunk)

print("Saved", output)