Generations
List generations API
List the generations of the workspace, newest first.
GET
https://serastudio.app/api/v1/generationsUsage notes
- The key needs the read permission.
- Pages hold up to 100 items. When
has_moreistrue, passnext_beforeasbeforefor the next page. - Each item is the same generation object as Get generation.
Quick start
curl "https://serastudio.app/api/v1/generations?model=siren&status=succeeded&limit=20" \
-H "Authorization: Bearer $SERA_API_KEY"Query parameters
modelstringOnly this mode: siren, siren-object-swap, siren-fast.
statusstringOnly this status: queued, in_progress, succeeded, failed or canceled.
limitintegerdefault: 20Items per page, 1 to 100.
beforestringReturn items created before this ISO 8601 time. Use next_before from the previous page.
Response
{
"object": "list",
"data": [
{
"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"
}
],
"has_more": false,
"next_before": null
}objectstringAlways list.
dataarrayGeneration objects, newest first.
has_morebooleanWhether older items exist.
next_beforestringThe created_at of the last item, to pass as before. null on the last page.
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 |
422 | invalid_parameter | A query parameter has a value the endpoint does not accept. error.param names it. | 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 |