Generations
Get generation API
Read one generation: status, progress, output, error and billing. Optionally wait for it to finish.
https://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.urlis 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: 0Seconds 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"
}idstringThe generation id. Use it with the get, cancel and delete endpoints, and as source.generation_id of a new request.
objectstringAlways generation.
modelstringThe mode: siren, siren-object-swap, siren-fast. fix for a fix.
statusstringqueued (not started, can be canceled), in_progress, succeeded, failed or canceled.
created_atstringWhen the request was accepted, ISO 8601 UTC.
finished_atstringWhen it reached a terminal status, or null.
inputobjectWhat was requested: source, images, prompt, resolution, source_duration_s, webhook_url.
progressobjectWhile queued or in progress: stage and percent. null once finished.
outputobjectWhen 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_deletedbooleantrue after the output was deleted, by you or by retention.
errorobjectWhen failed or canceled: code and an English message. null otherwise.
billingobjectcurrency, resolution, usd_per_second (the price this generation pays), discount_pct, held_usd, charged_usd (null until settled), restored_usd, settled.
idempotency_keystringThe Idempotency-Key you sent, or null.
fixobjectOnly 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
| Status | Code | When it happens | Retry |
|---|---|---|---|
401 | api_key_missing | No Bearer key was sent in the Authorization header. | No |
401 | api_key_invalid | The key is malformed or unknown. | No |
401 | api_key_revoked | The key was deleted in the console. | No |
401 | api_key_disabled | The key is disabled in the console. | No |
401 | api_key_expired | The key is past its expiration date. | No |
403 | insufficient_scope | The key lacks the read permission. Keys created in the console have it. | No |
403 | workspace_forbidden | The account that owns the workspace is suspended or scheduled for deletion. | No |
404 | not_found | No generation with that id exists in this workspace. | No |
503 | temporarily_unavailable | The request could not be completed just now. | Yes |
500 | internal_error | Something failed on our side. The request_id identifies the request. | Yes |
503 | api_unavailable | The API is turned off. | No |