Generations
Cancel generation API
Cancel a generation that is still queued. The whole hold is restored.
POST
https://serastudio.app/api/v1/generations/{id}/cancelUsage notes
- The key needs the create permission.
- Only
queuedgenerations can be canceled. Once one isin_progressor finished, the endpoint returns409 not_cancelable. - The response is the generation with status
canceled,billing.restored_usdequal to the hold andcharged_usdof0.
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
| 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 create 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 |
409 | not_cancelable | The generation already started or finished. | 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 |