Skip to main content
GET
Get run status and result
After submitting a run, poll with the returned run_id.

GET /v1/runs/

string
required
Same ID returned on submit.
string
required
queuedprocessingsucceeded | failed | timeout | cancelled
object
Present when status is succeeded. Shape depends on the model (images, video URL, audio, etc.).
object
{ code, message } when status is failed.

Example

Poll every 2–5 seconds until a terminal status.

POST /v1/runs/search

List runs for your organization:
Runs cannot be cancelled once submitted — they always proceed to a terminal state (succeeded, failed, or timeout). Failed and timed-out runs are never charged.

Authorizations

Authorization
string
header
required

API key: Key sk-xxx or Bearer sk-xxx

Path Parameters

run_id
string
required

Response

200 - application/json

Run status and result

run_id
string
required

Unique run identifier

endpoint
string
required

Model slug

model
string
required
capability
string
required
mode
string
required
status
enum<string>
required
Available options:
queued,
processing,
succeeded,
failed,
timeout,
cancelled
created_at
string<date-time>
required
output
object | null
error
object | null
billing
object | null
started_at
string<date-time> | null
completed_at
string<date-time> | null
elapsed_ms
number | null