API reference: one POST, then poll.

Authorization: Bearer av_live_…

curl https://agentvideo.app/v1/jobs \
  -H "Authorization: Bearer $AGENTVIDEO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: release-2.4-clip" \
  -d '{
    "style": "low-poly",
    "prompt": "A paper boat crosses a storm and reaches a lighthouse",
    "duration_s": 15,
    "aspect": "9:16",
    "tier": "standard",
    "options": { "captions": true, "language": "en", "sound": true }
  }'

# 202
# { "job": { "id": "…", "status": "queued", "cost_credits": 500,
#            "progress": { "phase": "queued", "pct": 0, "message": "…" }, … } }

curl https://agentvideo.app/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $AGENTVIDEO_KEY"

# while it runs
# { "job": { "status": "running", "progress": { "phase": "rendering", "pct": 72, "message": "…" } } }
# when it is done
# { "job": { "status": "succeeded", "video_url": "https://agentvideo.app/media/…/video.mp4?t=…",
#            "poster_url": "https://agentvideo.app/media/…/poster.jpg?t=…",
#            "width": 1080, "height": 1920, "expires_at": "…" } }

curl -L -o video.mp4 "$VIDEO_URL"

// Node 18+ (built-in fetch)
const API = 'https://agentvideo.app/v1'
const headers = { Authorization: 'Bearer ' + process.env.AGENTVIDEO_KEY, 'Content-Type': 'application/json' }

const res = await fetch(API + '/jobs', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    style: 'low-poly',
    prompt: 'A paper boat crosses a storm and reaches a lighthouse',
    duration_s: 15,
    aspect: '9:16',
    tier: 'standard',
  }),
})
if (!res.ok) throw new Error((await res.json()).error.message)
let { job } = await res.json()

while (job.status === 'queued' || job.status === 'running') {
  await new Promise((r) => setTimeout(r, 10_000))
  job = (await (await fetch(API + '/jobs/' + job.id, { headers })).json()).job
  console.log(job.progress.phase, job.progress.pct + '%')
}
if (job.status !== 'succeeded') throw new Error(job.error?.message ?? job.status)
console.log(job.video_url) // signed, valid for one hour

# pip install requests
import os, time, requests

API = "https://agentvideo.app/v1"
headers = {"Authorization": "Bearer " + os.environ["AGENTVIDEO_KEY"]}

r = requests.post(API + "/jobs", headers=headers, json={
    "style": "low-poly",
    "prompt": "A paper boat crosses a storm and reaches a lighthouse",
    "duration_s": 15,
    "aspect": "9:16",
    "tier": "standard",
})
if not r.ok:
    raise SystemExit(r.json()["error"]["message"])
job = r.json()["job"]

while job["status"] in ("queued", "running"):
    time.sleep(10)
    job = requests.get(API + "/jobs/" + job["id"], headers=headers).json()["job"]
    print(job["progress"]["phase"], job["progress"]["pct"])

if job["status"] != "succeeded":
    raise SystemExit(job.get("error", {}).get("message", job["status"]))
open("video.mp4", "wb").write(requests.get(job["video_url"]).content)