Generations
Delete generation API
Delete the output files of a finished generation right away. The record and its billing stay.
DELETE
https://serastudio.app/api/v1/generations/{id}Usage notes
- The key needs the delete permission.
- Deletes the MP4, the thumbnail and the working copies. The generation stays readable with
output: nullandoutput_deleted: true. - A queued or in-progress generation cannot be deleted (
409 not_deletable); cancel it or wait for it to finish. - Without a delete, the files are removed 7 days after the generation finished.
- Calling it again returns the current state with
200.
Quick start
curl -X DELETE https://serastudio.app/api/v1/generations/0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70 \
-H "Authorization: Bearer $SERA_API_KEY"Response
{
"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": null,
"output_deleted": true,
"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"
}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 delete 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_deletable | The generation is still queued or in progress. | 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 |