Explore models
Videofrom $0.1645 / s

Siren

Keeps the scene, cuts and camera of a source video and swaps one object for the product in your photo. Sources up to 30 s, up to 8 photos, output up to 1080p.

View docs
const res = await fetch('https://serastudio.app/api/v1/siren-object-swap/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-object-swap/generations
POST https://serastudio.app/api/v1/siren-object-swap/estimate

2. Authentication

Send your API key in the Authorization: Bearer header on every request.

3. Generation request parameters

ParameterTypeRequiredDefaultDescription
sourceobjectYAn uploaded video {upload_id} or a finished generation {generation_id}
imagesarrayY1 to 8 uploaded photos {upload_id}
promptstring-What to change, in words
resolutionstring-720p720p · 1080p
source_duration_snumber-304–30 s

4. Estimate request

const res = await fetch('https://serastudio.app/api/v1/siren-object-swap/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-object-swap",
  "currency": "usd",
  "resolution": "720p",
  "usd_per_second": 0.1645,
  "list_usd_per_second": 0.1645,
  "discount_pct": 0,
  "billable_seconds": 20,
  "source_seconds_billed": 10,
  "max_usd": 3.29,
  "min_source_seconds_billed": 4,
  "max_source_seconds": 30,
  "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."
}

View docs