GET /generation

Look up a generation of your Router space by id — its state, tokens, cost and attempts.

GET/api/v1/generation?id=gen-…API key

Returns a generation of the key's Router space. The content of the request and answer is never returned here. A generation of another space is 404.

Response

{
  "data": {
    "id": "gen-5d0c3b6e-…",
    "model": "google/gemma-3-4b-it",
    "requested_model": "openai/gpt-4o-mini",
    "created_at": "2026-10-28T09:34:12Z",
    "streamed": false,
    "cancelled": false,
    "state": "completed",
    "finish_reason": "stop",
    "usage_source": "upstream_cost",
    "total_cost": 0.0000146,
    "usage": 0.0000146,
    "tokens_prompt": 24,
    "tokens_completion": 14,
    "native_tokens_prompt": 24,
    "native_tokens_completion": 14,
    "native_tokens_reasoning": 0,
    "native_tokens_cached": 0,
    "provider_name": "global",
    "upstream_attempts": [
      { "attempt": 1, "provider": "global", "status": "failed", "billable": false, "http_status": 503 },
      { "attempt": 2, "provider": "global", "status": "succeeded", "billable": true, "http_status": 200 }
    ]
  }
}

Field
`model` / `requested_model`	The model that answered / the model of the request.
`state`	`running`, `completed`, `failed`, `cancelled` or `usage_unknown`.
`total_cost`, `usage`	The charge in PnP; `null` while the generation runs.
`tokens_prompt`, `tokens_completion`	Input and output tokens.
`native_tokens_prompt`, `native_tokens_completion`, `native_tokens_reasoning`, `native_tokens_cached`	The same counted by the provider, plus reasoning and cached tokens.
`provider_name`	The region of the answering route: `global` or `ru`.
`upstream_attempts`	Every attempt, with its region, status (`started`, `succeeded`, `partial`, `failed`, `cancelled`, `unknown`) and whether it was billed.
`usage_source`	Where the cost comes from: `upstream_cost` (the provider reported it), `generation_api`, `computed_usage` (tokens × prices) or `estimated` (no usage was reported, for example after a cancel).

Example

curl -s "https://router.nodul.ru/api/v1/generation?id=gen-5d0c3b6e-…" -H "Authorization: Bearer $NODUL_ROUTER_API_KEY"