Endpoints

Consultation d'une génération

GET /generation : retrouvez le coût exact, les tokens, le fournisseur et la latence d'une requête passée grâce à son identifiant de génération.

Consultez les détails d'une requête passée (son coût exact, le nombre de tokens, le fournisseur, la latence et le motif de fin) à partir de son identifiant de génération. Utile pour rapprocher des factures, auditer des requêtes en streaming et déboguer des appels lents.

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

Où trouver l'identifiant

Le champ id d'un chat completion, d'un completion ou d'une réponse (gen-...).
L'en-tête de réponse X-Generation-Id, quand il est présent.
L'id dans le premier fragment d'un flux.
La page Utilisation de votre tableau de bord.

Requête

Paramètre de requête	Obligatoire	Description
`id`	oui	L'identifiant de génération.

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

Vous ne pouvez consulter que les générations faites par votre propre compte. Tout autre identifiant (ou un identifiant jamais journalisé) renvoie 404 not_found.

Réponse

Le corps est l'enregistrement de la génération :

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

Champ	Description
`total_cost`	Le montant débité de votre solde, en USD.
`native_tokens_*`	Nombre de tokens selon le tokenizer propre au fournisseur, c'est ce qui vous est facturé.
`native_tokens_cached`	Tokens du prompt servis depuis le cache. Voir Cache de prompt.
`latency` / `generation_time`	Délai avant le premier token et durée totale de génération, en ms.

Coût

total_cost (et usage.cost dans la réponse d'origine) est ce qui vous est facturé pour la requête, le même montant que sur la page Utilisation. Voir Tarifs et facturation.

Délai

L'enregistrement peut mettre quelques secondes à apparaître après la fin d'une requête. Si vous recevez un 404 juste après une requête, réessayez après un court délai.

Erreurs

Statut	Code	Quand
401	`invalid_api_key`	Clé manquante ou invalide.
404	`not_found`	L'identifiant est inconnu ou appartient à un autre compte.
502	`upstream_unavailable`	L'enregistrement n'a pas pu être récupéré ; réessayez.

Voir Erreurs.