Endpoint

Ricerca di una generazione

Usa GET /generation per consultare costo esatto, token, provider, latenza e motivo di arresto di una richiesta passata a partire dal suo generation id.

Consulta i dettagli di una richiesta passata (costo esatto, conteggio dei token, provider, latenza e motivo di arresto) tramite il suo generation id. È utile per riconciliare le fatture, verificare le richieste in streaming e fare il debug delle chiamate lente.

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

Dove trovare l'id

Il campo id di una chat completion, completion o response (gen-...).
L'header di risposta X-Generation-Id, quando presente.
L'id nel primo chunk di uno stream.
La pagina Utilizzo della tua dashboard.

Richiesta

Parametro di query	Obbligatorio	Descrizione
`id`	sì	Il generation id.

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

Puoi consultare solo le generazioni effettuate dal tuo account. Qualsiasi altro id (o un id che non è mai stato registrato) restituisce 404 not_found.

Risposta

Il corpo è il record della generazione:

{
  "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	Descrizione
`total_cost`	L'importo scalato dal tuo saldo, in USD.
`native_tokens_*`	Conteggio dei token secondo il tokenizer del provider, ed è quello che ti viene fatturato.
`native_tokens_cached`	Token del prompt serviti dalla cache. Vedi Prompt caching.
`latency` / `generation_time`	Tempo al primo token e tempo totale di generazione, in ms.

Costo

total_cost (e usage.cost nella risposta originale) è l'importo addebitato per la richiesta, lo stesso mostrato nella pagina Utilizzo. Vedi Prezzi e fatturazione.

Tempistiche

Il record può impiegare alcuni secondi ad apparire dopo la fine di una richiesta. Se ricevi un 404 subito dopo una richiesta, riprova dopo una breve attesa.

Errori

Stato	Codice	Quando
401	`invalid_api_key`	Chiave mancante o non valida.
404	`not_found`	L'id è sconosciuto o appartiene a un altro account.
502	`upstream_unavailable`	Non è stato possibile recuperare il record; riprova.

Vedi Errori.