Quickstart
Generate your first video in under five minutes.
1. Get an API key
Sign in to the SwishX API Platform and generate a key from the API Keys page. Keys are shown in full exactly once, then stored only as a hash — copy it somewhere safe.
New accounts
New accounts start with a $0 balance. Add funds from the Billing page, or apply for $25 in free credit via Request access.
Export it as an environment variable so it never ends up hardcoded in your code:
export SWISHX_API_KEY="sx_live_..."2. Make a request
curl https://api.swishx.com/v1/videos \
-H "Authorization: Bearer $SWISHX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "finsen-3.2",
"prompt": "A pharma rep opens with a warm, confident smile.",
"duration_seconds": 8
}'This returns immediately with the generation in a queued state — it hasn't rendered yet:
{
"id": "vid_8f2c1a9b3d4e",
"object": "video",
"status": "queued",
"model": "finsen-3.2",
"created_at": "2026-08-07T18:22:04Z"
}3. Poll for the result
Generation runs asynchronously through all six reasoning stages. Poll the generation until status is succeeded
or failed:
curl https://api.swishx.com/v1/videos/vid_8f2c1a9b3d4e \
-H "Authorization: Bearer $SWISHX_API_KEY"{
"id": "vid_8f2c1a9b3d4e",
"object": "video",
"status": "succeeded",
"model": "finsen-3.2",
"routed_model": "veo-3",
"compliance": { "verified": true, "flags": [] },
"output": {
"url": "https://cdn.swishx.com/videos/vid_8f2c1a9b3d4e.mp4",
"thumbnail_url": "https://cdn.swishx.com/videos/vid_8f2c1a9b3d4e.jpg"
},
"cost_cents": 1200,
"created_at": "2026-08-07T18:22:04Z",
"completed_at": "2026-08-07T18:24:41Z"
}Next
Read The reasoning pipeline to see what happens between queued and
succeeded, or jump straight to the full endpoint reference.