Jobs

The same request body as a task. POST /v1/jobs answers 202 at once with the job object; the client polls GET /v1/jobs/{id} or waits for the SDK's helper. Video, long audio and batched generation are jobs; any task type may be submitted as a job.

POST/v1/jobspreview

An asynchronous job: the same body as a task, answered 202 with the job object.

GET/v1/jobs/{id}preview

The job object with its status, transitions, result, usage and error.

GET/v1/jobspreview

The workspace's jobs, newest first, cursor-paginated.

POST/v1/jobs/{id}/cancelpreview

Cancels a queued, assigned or running job.

Fig. 1, sheet 11API reference

Job object

00000000000000000000000000000000000000001{2  "object": "job",3  "id": "job_...",4  "status": "queued",5  "model": "<pinned id>",6  "task": "video_generation",7  "created_at": "2026-10-20T12:00:00Z",8  "transitions": [{"status": "queued", "at": "2026-10-20T12:00:00Z"}],9  "requirements": {"pool": "approved", "pricing_mode": "market", "region": null, "fallback": false},10  "quote": "quote_...",11  "result": null,12  "error": null,13  "usage": null,14  "expires_at": null15}

Job object sample

States

Status	Meaning	Terminal
`queued`	Accepted, quote bound, no worker yet	No
`assigned`	A worker took it; the attempt is `att_`	No
`running`	The worker reported a start	No
`completed`	`result` is set; `usage` and the cost are final	Yes
`failed`	`error` is set (the envelope's shape); nothing billed unless the retries page says otherwise	Yes
`canceled`	By `POST /v1/jobs/{id}/cancel`, by a client disconnect or by the workspace being paused; the running attempt, if any, ends `interrupted` with reason `canceled`	Yes
`interrupted`	An attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billed	Yes

Every transition carries a timestamp and, when the scheduler has one, an explanation. An attempt interrupted before any output returns the job to queued while attempts remain.

Routes

Parts list: Behavior

GET /v1/jobs/{id}
The job object. result holds inline results (the task's result shape) or, for media, outputs: [{upload_id, download_url, content_type, bytes, expires_at}] with a presigned GET. Another workspace's job is a 404 job_not_found.
GET /v1/jobs
The key's workspace's jobs, newest first, cursor-paginated, filterable by status, model, deployment and task.
POST /v1/jobs/{id}/cancel
queued: canceled at once, nothing billed. assigned or running: cancellation is sent to the worker; the attempt ends interrupted with reason canceled and the job ends canceled; the charge for work done is Not decided yet (proposed: nothing). A terminal job answers 200 with the job unchanged.
Expiry
result and outputs are retrievable until expires_at Not decided yet; the job record and its usage stay. A read after expiry is a 404 result_expired on result; the job object itself still answers.
Webhooks
None in this version; a completion webhook is open Not decided yet. The Console shows job progress.

Errors these routes can answer

Status	Type	Code	Situation	Retry
400	`invalid_request_error`	`use_jobs`	A synchronous task the gateway can tell will exceed the synchronous limit	As a job
400	`invalid_request_error`	`invalid_idempotency_key`, `idempotency_key_reused`, `idempotency_in_progress`	The idempotency rules	The last one, later
402	`insufficient_credit`	`insufficient_credit`	The balance does not cover the request's maximum cost at the bound quote. On the free plan with the allowance used, the message names when it resets	After a top-up
404	`not_found_error`	`job_not_found`, `upload_not_found`	An id in the path that is unknown or another workspace's	No
404	`not_found_error`	`result_expired`	A job's result read after `expires_at`	No
429	`rate_limit_error`	`concurrency_limit_exceeded`	Too many concurrent streams or active jobs; `param` is `streams` or `jobs`; `Retry-After`	Yes, after `Retry-After`

Sheet: 11 of 13
Detail: F
Updated: 2026-10-21
Status: Preview

Join early access

1{2 "object": "job",3 "id": "job_...",4 "status": "queued",5 "model": "<pinned id>",6 "task": "video_generation",7 "created_at": "2026-10-20T12:00:00Z",8 "transitions": [{"status": "queued", "at": "2026-10-20T12:00:00Z"}],9 "requirements": {"pool": "approved", "pricing_mode": "market", "region": null, "fallback": false},10 "quote": "quote_...",11 "result": null,12 "error": null,13 "usage": null,14 "expires_at": null15}

Status

Meaning

Terminal

queued

Accepted, quote bound, no worker yet

assigned

A worker took it; the attempt is att_

running

The worker reported a start

completed

result is set; usage and the cost are final

Yes

failed

error is set (the envelope's shape); nothing billed unless the retries page says otherwise

Yes

canceled

By POST /v1/jobs/{id}/cancel, by a client disconnect or by the workspace being paused; the running attempt, if any, ends interrupted with reason canceled

Yes

interrupted

An attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billed

Yes

Status

Type

Code

Situation

Retry

400

invalid_request_error

use_jobs

A synchronous task the gateway can tell will exceed the synchronous limit

As a job

400

invalid_request_error

invalid_idempotency_key, idempotency_key_reused, idempotency_in_progress

The idempotency rules

The last one, later

402

insufficient_credit

The balance does not cover the request's maximum cost at the bound quote. On the free plan with the allowance used, the message names when it resets

After a top-up

404

not_found_error

job_not_found, upload_not_found

An id in the path that is unknown or another workspace's

404

not_found_error

result_expired

A job's result read after expires_at

429

rate_limit_error

concurrency_limit_exceeded

Too many concurrent streams or active jobs; param is streams or jobs; Retry-After

Yes, after Retry-After

States

Routes

Errors these routes can answer

Related sheets

States

Routes

Errors these routes can answer

Related sheets