GenerationsGet generation

Generations

Get generation API

Read one generation: status, progress, output, error and billing. Optionally wait for it to finish.

GEThttps://serastudio.app/api/v1/generations/{id}

Usage notes

  • The key needs the read permission.
  • wait_s (0 to 20) makes the server wait up to that many seconds for a terminal status before answering. Use it instead of tight polling.
  • output.url is signed and expires (output.url_expires_at). Get the generation again for a fresh one. The file is deleted 7 days after the generation finished.
  • Only generations made through the API appear here. Videos made in the Sera Studio app are not generations.

Quick start

curl "https://serastudio.app/api/v1/generations/0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70?wait_s=20" \
  -H "Authorization: Bearer $SERA_API_KEY"

Query parameters

wait_sintegerdefault: 0

Seconds to wait for the generation to finish, 0 to 20.

Response

A finished generation:

{
  "id": "0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70",
  "object": "generation",
  "model": "siren",
  "status": "succeeded",
  "created_at": "2026-11-09T05:11:02.000Z",
  "finished_at": "2026-11-09T05:14:40.000Z",
  "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": null,
  "output": {
    "url": "https://rvzzbovxmjgldcnlbwyx.supabase.co/storage/v1/object/sign/episodes/7d9e2f10-4b3a-4c5d-8e6f-0a1b2c3d4e5f/episodes/0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70/a1/master.mp4?token=<signed>",
    "thumbnail_url": "https://rvzzbovxmjgldcnlbwyx.supabase.co/storage/v1/object/sign/episodes/7d9e2f10-4b3a-4c5d-8e6f-0a1b2c3d4e5f/episodes/0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70/a1/thumb.jpg?token=<signed>",
    "duration_s": 9.4,
    "url_expires_at": "2026-11-09T06:15:00.000Z",
    "retained_until": "2026-11-16T05:14:40.000Z"
  },
  "output_deleted": false,
  "error": null,
  "billing": {
    "currency": "usd",
    "resolution": "720p",
    "usd_per_second": 0.175,
    "discount_pct": 0,
    "held_usd": 3.5,
    "charged_usd": 3.5,
    "restored_usd": 0,
    "settled": true
  },
  "idempotency_key": "order-1182"
}
idstring

The generation id. Use it with the get, cancel and delete endpoints, and as source.generation_id of a new request.

objectstring

Always generation.

modelstring

The mode: siren, siren-object-swap, siren-fast. fix for a fix.

statusstring

queued (not started, can be canceled), in_progress, succeeded, failed or canceled.

created_atstring

When the request was accepted, ISO 8601 UTC.

finished_atstring

When it reached a terminal status, or null.

inputobject

What was requested: source, images, prompt, resolution, source_duration_s, webhook_url.

progressobject

While queued or in progress: stage and percent. null once finished.

outputobject

When succeeded and still retained: url (signed MP4, expires at url_expires_at; call again for a fresh one), thumbnail_url, duration_s, retained_until (7 days after it finished). null otherwise.

output_deletedboolean

true after the output was deleted, by you or by retention.

errorobject

When failed or canceled: code and an English message. null otherwise.

billingobject

currency, resolution, usd_per_second (the price this generation pays), discount_pct, held_usd, charged_usd (null until settled), restored_usd, settled.

idempotency_keystring

The Idempotency-Key you sent, or null.

fixobject

Only on a fix: kind, start_s, end_s, window_seconds, video_id, on_version, retry_discount_pct.

A canceled generation has error set and its full hold restored:

{
  "id": "0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70",
  "object": "generation",
  "model": "siren",
  "status": "canceled",
  "created_at": "2026-11-09T05:11:02.000Z",
  "finished_at": "2026-11-09T05:11:30.000Z",
  "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": null,
  "output": null,
  "output_deleted": false,
  "error": {
    "code": "user_cancelled",
    "message": "Canceled. Your credits were restored."
  },
  "billing": {
    "currency": "usd",
    "resolution": "720p",
    "usd_per_second": 0.175,
    "discount_pct": 0,
    "held_usd": 3.5,
    "charged_usd": 0,
    "restored_usd": 3.5,
    "settled": true
  },
  "idempotency_key": "order-1182"
}

Errors

StatusCodeWhen it happensRetry
401api_key_missingNo Bearer key was sent in the Authorization header.No
401api_key_invalidThe key is malformed or unknown.No
401api_key_revokedThe key was deleted in the console.No
401api_key_disabledThe key is disabled in the console.No
401api_key_expiredThe key is past its expiration date.No
403insufficient_scopeThe key lacks the read permission. Keys created in the console have it.No
403workspace_forbiddenThe account that owns the workspace is suspended or scheduled for deletion.No
404not_foundNo generation with that id exists in this workspace.No
503temporarily_unavailableThe request could not be completed just now.Yes
500internal_errorSomething failed on our side. The request_id identifies the request.Yes
503api_unavailableThe API is turned off.No