Endpoints

Consulta de geração

Consulte o custo exato, os tokens, o provedor, a latência e o motivo de término de uma requisição passada pelo id de geração com GET /generation.

Consulte os detalhes de uma requisição passada (custo exato, contagem de tokens, provedor, latência e motivo de término) pelo id de geração. É útil para conciliar cobranças, auditar requisições com streaming e depurar chamadas lentas.

GET https://api14.com/api/v1/generation?id={generation_id}

Onde encontrar o id

O campo id de um chat completion, completion ou response (gen-...).
O cabeçalho de resposta X-Generation-Id, quando presente.
O id no primeiro chunk de um stream.
A página Usage do seu painel.

Requisição

Parâmetro de query	Obrigatório	Descrição
`id`	sim	O id da geração.

curl "https://api14.com/api/v1/generation?id=gen-1791100000-abc123" \
  -H "Authorization: Bearer sk-api14-..."

Você só pode consultar gerações feitas pela sua própria conta. Qualquer outro id (ou um id que nunca foi registrado) retorna 404 not_found.

Resposta

O corpo é o registro da geração:

{
  "data": {
    "id": "gen-1791100000-abc123",
    "model": "anthropic/claude-sonnet-4.5",
    "created_at": "2026-10-04T09:12:44Z",
    "provider_name": "Anthropic",
    "streamed": true,
    "finish_reason": "stop",
    "tokens_prompt": 1250,
    "tokens_completion": 340,
    "native_tokens_prompt": 1310,
    "native_tokens_completion": 352,
    "native_tokens_reasoning": 0,
    "native_tokens_cached": 1024,
    "latency": 412,
    "generation_time": 3810,
    "total_cost": 0.00918
  }
}

Campo	Descrição
`total_cost`	O valor debitado do seu saldo, em USD.
`native_tokens_*`	Contagens de tokens do tokenizador do próprio provedor; são elas que você paga.
`native_tokens_cached`	Tokens do prompt servidos a partir do cache. Veja Prompt caching.
`latency` / `generation_time`	Tempo até o primeiro token e tempo total de geração, em ms.

Custo

total_cost (e usage.cost na resposta original) é o valor cobrado pela requisição, o mesmo exibido na página Usage. Veja Preços e cobrança.

Tempo de disponibilidade

O registro pode levar alguns segundos para aparecer depois que a requisição termina. Se você receber um 404 logo após uma requisição, tente novamente após um breve intervalo.

Erros

Status	Código	Quando
401	`invalid_api_key`	Chave ausente ou inválida.
404	`not_found`	O id é desconhecido ou pertence a outra conta.
502	`upstream_unavailable`	Não foi possível buscar o registro; tente novamente.

Veja Erros.