GenerationsList generations

Generations

List generations API

List the generations of the workspace, newest first.

GEThttps://serastudio.app/api/v1/generations

Usage notes

  • The key needs the read permission.
  • Pages hold up to 100 items. When has_more is true, pass next_before as before for 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

modelstring

Only this mode: siren, siren-object-swap, siren-fast.

statusstring

Only this status: queued, in_progress, succeeded, failed or canceled.

limitintegerdefault: 20

Items per page, 1 to 100.

beforestring

Return 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
}
objectstring

Always list.

dataarray

Generation objects, newest first.

has_moreboolean

Whether older items exist.

next_beforestring

The created_at of the last item, to pass as before. null on the last page.

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
422invalid_parameterA query parameter has a value the endpoint does not accept. error.param names it.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