GenerationsCancel generation

Generations

Cancel generation API

Cancel a generation that is still queued. The whole hold is restored.

POSThttps://serastudio.app/api/v1/generations/{id}/cancel

Usage notes

  • The key needs the create permission.
  • Only queued generations can be canceled. Once one is in_progress or finished, the endpoint returns 409 not_cancelable.
  • The response is the generation with status canceled, billing.restored_usd equal to the hold and charged_usd of 0.

Quick start

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

Response

{
  "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 create 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
409not_cancelableThe generation already started or finished.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