GET /generation

Найдите генерацию своего пространства Router по ID — ее состояние, токены, стоимость и попытки.

GET/api/v1/generation?id=gen-…API-ключ

Возвращает генерацию пространства Router, которому принадлежит ключ. Содержимое запроса и ответа здесь никогда не возвращается. Генерация другого пространства дает 404.

Ответ

{
  "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 }
    ]
  }
}

Поле
`model` / `requested_model`	Модель, которая ответила / модель из запроса.
`state`	`running`, `completed`, `failed`, `cancelled` или `usage_unknown`.
`total_cost`, `usage`	Сумма списания в PnP; `null`, пока генерация выполняется.
`tokens_prompt`, `tokens_completion`	Входные и выходные токены.
`native_tokens_prompt`, `native_tokens_completion`, `native_tokens_reasoning`, `native_tokens_cached`	То же по подсчету провайдера, а также токены рассуждений и кешированные токены.
`provider_name`	Регион маршрута, который ответил: `global` или `ru`.
`upstream_attempts`	Все попытки с регионом, статусом (`started`, `succeeded`, `partial`, `failed`, `cancelled`, `unknown`) и признаком оплаты.
`usage_source`	Откуда взята стоимость: `upstream_cost` (ее сообщил провайдер), `generation_api`, `computed_usage` (токены × цены) или `estimated` (провайдер не сообщил расход, например после отмены).

Пример

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