Skip to main content
GET
/
generation
Get request & usage metadata for a generation
curl --request GET \
  --url https://openrouter.ai/api/v1/generation \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "api_type": "completions",
    "app_id": 12345,
    "cache_discount": null,
    "cancelled": false,
    "created_at": "2024-07-15T23:33:19.433273+00:00",
    "external_user": "user-123",
    "finish_reason": "stop",
    "generation_time": 1200,
    "http_referer": "https://openrouter.ai/",
    "id": "gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG",
    "is_byok": false,
    "latency": 1250,
    "model": "sao10k/l3-stheno-8b",
    "moderation_latency": 50,
    "native_finish_reason": "stop",
    "native_tokens_cached": 3,
    "native_tokens_completion": 25,
    "native_tokens_completion_images": 0,
    "native_tokens_prompt": 10,
    "native_tokens_reasoning": 5,
    "num_input_audio_prompt": 0,
    "num_media_completion": 0,
    "num_media_prompt": 1,
    "num_search_results": 5,
    "origin": "https://openrouter.ai/",
    "provider_name": "Infermatic",
    "provider_responses": null,
    "request_id": "req-1727282430-aBcDeFgHiJkLmNoPqRsT",
    "router": "openrouter/auto",
    "session_id": null,
    "streamed": true,
    "tokens_completion": 25,
    "tokens_prompt": 10,
    "total_cost": 0.0015,
    "upstream_id": "chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946",
    "upstream_inference_cost": 0.0012,
    "usage": 0.0015,
    "user_agent": "Mozilla/5.0"
  }
}

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Query Parameters

id
string
required

The generation ID

Minimum string length: 1
Example:

"gen-1234567890"

Response

Returns the request metadata for this generation

Generation response

data
object
required

Generation data