Explore models
Videofrom $0.0875 / s
Siren
Swaps the people, outfits and background in a source video to match your photos while keeping its motion and camera. Sources up to 15 s, up to 8 photos, output up to 1080p.
const res = await fetch('https://serastudio.app/api/v1/siren/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.SERA_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'order-1182',
},
body: JSON.stringify({ source: { upload_id: 'vid_…' }, images: [{ upload_id: 'img_…' }], resolution: '720p', source_duration_s: 9.4 }),
});
const generation = await res.json();
console.log(generation.id, generation.status);1. Calling the API
POST https://serastudio.app/api/v1/siren/generations POST https://serastudio.app/api/v1/siren/estimate
2. Authentication
Send your API key in the Authorization: Bearer header on every request.
3. Generation request parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| source | object | Y | An uploaded video {upload_id} or a finished generation {generation_id} | |
| images | array | Y | 1 to 8 uploaded photos {upload_id} | |
| prompt | string | - | What to change, in words | |
| resolution | string | - | 480p | 480p · 720p · 1080p |
| source_duration_s | number | - | 15 | 1–15 s |
4. Estimate request
const res = await fetch('https://serastudio.app/api/v1/siren/estimate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.SERA_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ resolution: '720p', source_duration_s: 9.4 }),
});
const estimate = await res.json();
console.log(estimate);5. Estimate response
{
"model": "siren",
"currency": "usd",
"resolution": "720p",
"usd_per_second": 0.175,
"list_usd_per_second": 0.175,
"discount_pct": 0,
"billable_seconds": 20,
"source_seconds_billed": 10,
"max_usd": 3.5,
"min_source_seconds_billed": 4,
"max_source_seconds": 15,
"note": "Billable seconds = output duration + input video duration. A generation holds max_usd from your balance, then charges the finished length and restores the rest."
}