Make AutoPersonify videos from your own software

Integrate my AutoPersonify account so I can make AI presenter videos (with a stock presenter or my own digital twin) from this app.

1. Read the docs at https://autopersonify.com/developers.md (OpenAPI: https://autopersonify.com/openapi.json).
2. Ask me for my AutoPersonify API key and store it as a server-side secret named AUTOPERSONIFY_API_KEY. Never expose it to the browser.
3. Make all calls from server code to https://autopersonify.com/api/v1 with the header Authorization: Bearer <key>.
4. Build a page where I pick a presenter (GET /presenters, show thumbnail + preview video) or one of my twins (GET /twins, only those with usable_in_videos=true), type or generate a script, and create the video (POST /videos with an idempotency_key).
5. Track status by polling GET /videos/{id} every 10–15 seconds (or via webhook) and show the finished video_url in a player.
6. Handle every error exactly as the docs' error table says — always show error.user_message, and show an Upgrade button linking to error.upgrade_url when error.action is "upgrade".

# 1. See who can present
curl https://autopersonify.com/api/v1/presenters -H "Authorization: Bearer $AUTOPERSONIFY_API_KEY"

# 2. Make a video (use twin_id instead of presenter_id for your twin)
curl -X POST https://autopersonify.com/api/v1/videos \
  -H "Authorization: Bearer $AUTOPERSONIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"presenter_id":"<id>","script":"Hi Sarah, here is this week in your ads...","idempotency_key":"ppc-2026-09-26-client-42"}'

# 3. Check progress until status is "ready"
curl https://autopersonify.com/api/v1/videos/<video id> -H "Authorization: Bearer $AUTOPERSONIFY_API_KEY"

// JavaScript (server only)
const res = await fetch("https://autopersonify.com/api/v1/videos", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUTOPERSONIFY_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ twin_id, script, idempotency_key: reportId }),
});
const body = await res.json();
if (!res.ok) throw Object.assign(new Error(body.error.user_message), body.error);

# Python
import os, requests
r = requests.post("https://autopersonify.com/api/v1/videos",
    headers={"Authorization": f"Bearer {os.environ['AUTOPERSONIFY_API_KEY']}"},
    json={"presenter_id": pid, "script": script, "idempotency_key": report_id})
data = r.json()
if not r.ok: print(data["error"]["user_message"])