Skip to content
Documentation
GuidesAPI ReferenceIntegrations
ArenaPlatform
API Reference/Usage

Get a Generation

GET/v1/generation

Overview

OpenRouter-compatible generation details from durable accounting records. id accepts the response id (gen-…, msg_gen-…, resp_…) or the x-request-id header. An API key sees its own requests; a dashboard session sees its workspaces'. Unknown IDs and other owners' IDs both return 404. Costs and tokens are null until the request settles. Also available under /api/v1.

Authorization

Authorizationstring · headerRequired

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

Parameters

idquery · stringRequired

Responses

200Generation details.
application/json
dataobjectRequired
Show nested fields
idstringRequired

gen-<unix seconds>-<32 hex digits>

request_idstringRequired

The x-request-id of the response.

modelstring | nullRequired
provider_namestring | null
api_typestring

Values: "chat""messages""responses""embeddings"

streamedboolean
created_atstring
billing_statestringRequired

Values: "pending""settled"

total_costnumber | null

Settled customer charge in USD.

usagenumber | null
is_byokboolean
originstring
latencyinteger | null

Milliseconds to the first token, else to completion.

generation_timeinteger | null
finish_reasonstring | null
native_finish_reasonstring | null
cancelledboolean
tokens_promptinteger | null
tokens_completioninteger | null
native_tokens_promptinteger | null
native_tokens_completioninteger | null
native_tokens_reasoninginteger | null
native_tokens_cachedinteger | null
routerstring | null
attemptsinteger
provider_responsesobject[]Required
Show nested fields
idstring
provider_namestring | null
modelstring | null
rolestring | null
statusinteger | null

Upstream HTTP status.

outcomestring

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

failure_causestring | null
latencyinteger | null
ttftinteger | null
finish_reasonstring | null
routingobjectRequired
Show nested fields
modestring

Values: "direct""named""auto""fusion""fallback"

requested_modelstring | null
policystring | null
releasedstring

Values: "unresolved""review""abandoned"

400Request validation failed.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

401Authentication is missing or invalid.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

404Resource was not found.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

500Internal server error.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.