Get request & usage metadata for a generation | OpenRouter

curl -G https://openrouter.ai/api/v1/generation \
     -H "Authorization: Bearer <token>" \
     -d id=gen-1234567890

{
  "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_fetches": 0,
    "num_input_audio_prompt": 0,
    "num_media_completion": 0,
    "num_media_prompt": 1,
    "num_search_results": 5,
    "origin": "https://openrouter.ai/",
    "preset_id": "a9e8d400-592a-494f-908c-375efa66cafd",
    "provider_name": "Infermatic",
    "provider_responses": null,
    "router": "openrouter/auto",
    "service_tier": "priority",
    "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",
    "web_search_engine": "exa",
    "request_id": "req-1727282430-aBcDeFgHiJkLmNoPqRsT",
    "session_id": null
  }
}

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Query parameters

idstringRequired>=1 character

The generation ID

Response

Returns the request metadata for this generation

dataobject

Generation data

Errors

401

Unauthorized Error

402

Payment Required Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error