JsonCutDocs
V2 APIEndpointsGeneration

Get a generation

Status, progress and, once completed, the result media. wait (seconds, up to 25) holds the answer until the generation ends or the time is up. Required API key scopes: `projects:read`.

GET
/api/v2/projects/{id}/generations/{operationId}

Authorization

apiKeyAuth

Path Parameters

id*string

Resource identifier

operationId*string

Resource identifier

Query Parameters

wait?integer

Seconds to wait for the end

Range0 <= value <= 25

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/projects/string/generations/string"
{  "success": true,  "data": {    "id": "aiop_01J",    "projectId": "project_01J",    "kind": "image",    "status": "completed",    "model": "openai/gpt-image-2.6/sunburst",    "prompt": "A pumpkin field at golden hour",    "progress": 100,    "credits": 12,    "media": {      "id": "media_01J",      "name": "pumpkin-field.png",      "kind": "image",      "mimeType": "image/png",      "width": 1536,      "height": 1024    },    "createdAt": "2026-11-11T09:00:00.000Z",    "updatedAt": "2026-11-11T09:00:21.000Z",    "completedAt": "2026-11-11T09:00:21.000Z"  }}

Generate an image, video, music or sound POST

Start an AI generation; the result lands in the project media. Credits are reserved now and settled when it ends (released when it fails). wait (seconds, up to 25) answers with the finished generation when it is done by then; otherwise 202 with its status: poll GET /projects/{id}/generations/{operationId}. Required API key scopes: `projects:read`, `media:write`.

Cancel a running generation DELETE

Stops a queued or running generation and releases its reserved credits. Required API key scopes: `operations:cancel`.