Get Image Status

GET/v1/images/requests/{request_id}

Overview

Read the durable state with the originating API key and requests.read scope. Does not dispatch inference or expose provider credentials, raw errors, prompts, images or native costs. Also available under /api/v1.

Authorization

Authorizationstring · headerRequired

AudioLab API key sent as Bearer <token>. Authentication guide

Parameters

request_idpath · stringRequired

Responses

200Owned image request metadata.

application/json

idstring

modelstring

statestring

Values: "dispatching""unknown""succeeded""failed""review"

settledboolean

coststring | null

Settled customer USD; null while unresolved.

created_atstring

401Invalid API key.

403Missing requests.read scope.

404Request does not belong to this API key.

Replace uppercase placeholders before running. JavaScript examples require Node.js 22 or later; Python examples require requests. WebSocket examples require the Node.js ws package. See setup for credentials.

curl --fail --show-error --request GET \
  --url "$AUDIOLAB_API_URL/v1/images/requests/YOUR_REQUEST_ID" \
  --header "Authorization: Bearer $AUDIOLAB_API_KEY"

{
  "id": "VALUE",
  "model": "VALUE",
  "state": "dispatching",
  "settled": false,
  "cost": "VALUE",
  "created_at": "VALUE"
}

Example responses · See schemas for all fields