Get started
Sera Studio API
The API for Siren, Sera Studio's video model.
Siren can swap the people, outfits or background in a video for the ones in your photos. The new video follows the camera and motion of the original. The API uploads your files, creates generations, reports their status and returns the finished MP4.
Run your first requestCreate an API key, add funds and make your first Siren video.Get an API keyCreate and manage server-side keys in the Sera Studio API console.
How a generation works
- Upload the source video and the reference photos. Each upload returns an id.
- Create a generation with those ids. The response is
202and the price is held from your balance. - Get the generation until its status is
succeeded;output.urlis the finished MP4. The final charge replaces the hold.
Make a request
Every endpoint uses the same Authorization header. A generation request looks like this:
curl https://serastudio.app/api/v1/siren/generations \
-H "Authorization: Bearer $SERA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1182" \
-d '{"source": {"upload_id": "vid_…"}, "images": [{"upload_id": "img_…"}], "resolution": "720p", "source_duration_s": 9.4}'The API accepts it with 202 and the generation object:
{
"id": "0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70",
"object": "generation",
"model": "siren",
"status": "queued",
"created_at": "2026-11-09T05:11:02.000Z",
"finished_at": null,
"input": {
"source": {
"upload_id": "vid_3f2c7a9e-5d1b-4c8e-9f20-7a6b5c4d3e21"
},
"images": [
{
"upload_id": "img_9a0b8c7d-6e5f-4a3b-8c2d-1e0f9a8b7c6d"
}
],
"prompt": "Keep the motion.",
"resolution": "720p",
"source_duration_s": 9.4,
"webhook_url": null
},
"progress": {
"stage": "queued",
"percent": 0
},
"output": null,
"output_deleted": false,
"error": null,
"billing": {
"currency": "usd",
"resolution": "720p",
"usd_per_second": 0.175,
"discount_pct": 0,
"held_usd": 3.5,
"charged_usd": null,
"restored_usd": 0,
"settled": false
},
"idempotency_key": "order-1182"
}