Get startedOverview

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.

How a generation works

  1. Upload the source video and the reference photos. Each upload returns an id.
  2. Create a generation with those ids. The response is 202 and the price is held from your balance.
  3. Get the generation until its status is succeeded; output.url is 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"
}

Choose your path