GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Tous les guides

· reAPI Team

Réponse vide OpenRouter facturée ? Lisez d’abord l’usage

Une réponse vide d’OpenRouter peut cacher un raisonnement facturé ou un échec client. Vérifie les motifs de fin, l’usage, Zero Completion Insurance et les frais auxiliaires.

Réponse vide OpenRouter facturée ? Lisez d’abord l’usage

La réponse est vide, mais usage.cost n’est pas égal à zéro. Avant de contester les frais ou de renvoyer le prompt, examine le reste de cette réponse. Un champ content vide ne permet pas de savoir si le modèle n’a produit aucun jeton, a dépensé son budget en raisonnement ou a renvoyé un élément que ton interface n’a pas affiché.

Cette distinction compte sur OpenRouter. Zero Completion Insurance couvre certains échecs de génération, tandis que le raisonnement peut être facturé sans réponse visible. Les deux situations peuvent laisser une bulle de chat vide. Le motif de fin et l’enregistrement d’usage permettent de les distinguer.[1][2]

La réponse manquante peut apparaître dans le nombre de jetons

Voici un extrait illustratif d’une réponse Chat Completions. Les nombres sont inventés, aucune requête n’a été exécutée et les champs sans rapport avec cette explication sont omis. Il montre le cas documenté où le raisonnement consomme le quota de sortie :[2]

{
  "choices": [
    {
      "message": { "content": "" },
      "finish_reason": "length"
    }
  ],
  "usage": {
    "completion_tokens": 1200,
    "completion_tokens_details": {
      "reasoning_tokens": 1200
    }
  }
}

Lis les trois valeurs ensemble. content ne contient aucune réponse. length indique que la génération a atteint sa limite de sortie. Le nombre de jetons de complétion est de 1 200, et le détail du raisonnement en représente les 1 200. Le nombre de jetons visibles dans cet exemple est donc de 1 200 moins 1 200 : zéro. Zéro texte visible ne signifie pas zéro sortie du modèle.

Chez la plupart des fournisseurs, le raisonnement et la sortie visible partagent le budget de sortie de la requête. OpenRouter compte le raisonnement comme sortie pour la facturation.[2] Une requête peut donc épuiser le quota avant d’atteindre la partie que tu voulais lire. C’est un résultat insatisfaisant pour l’application, mais différent de la condition de zéro complétion décrite dans la police d’assurance.

L’exemple omet volontairement tout montant en dollars. Le nombre de jetons ne détermine pas un prix sans le modèle et le tarif applicables. Cherche le usage.cost réel dans ta réponse ou dans l’enregistrement de génération correspondant, au lieu d’attribuer à cet exemple fictif les frais d’un modèle réel.

Masquer le raisonnement ne permet pas d’économiser ces jetons. Avec Chat Completions, reasoning.exclude: true supprime le raisonnement renvoyé tout en laissant le travail et sa facturation inchangés. L’API Responses ignore ce paramètre d’exclusion.[2] Sans réponse visible et avec le raisonnement masqué, l’interface peut être entièrement vide alors que les enregistrements d’usage indiquent qu’un travail a été effectué.

Avant de répéter la requête sans la modifier, examine les contrôles de raisonnement pris en charge par le modèle sélectionné. Un niveau d’effort plus faible mais pris en charge, ou un budget de raisonnement adapté, peut laisser de la place à une réponse. Augmenter le quota de sortie total permet aussi davantage de travail et peut entraîner plus de frais. Choisis le changement en fonction de la tâche et examine le résultat suivant ; aucun de ces réglages ne garantit universellement un texte utile.

Un autre motif de fin change la question de facturation

Considère maintenant un autre enregistrement : les jetons de complétion sont à zéro et le motif de fin est vide ou nul. OpenRouter indique que cette combinaison est protégée. Un motif de fin error est également indiqué comme condition admissible. Pour les requêtes couvertes, les frais des jetons de prompt, de complétion et de raisonnement sont nuls ; la protection est automatique.[1]

Garde ces conditions telles quelles. « L’application n’a rien affiché » est une affirmation plus large. Un motif d’arrêt normal, un appel d’outil, un résultat structuré ou un échec d’analyse côté client nécessite l’examen de la charge utile complète. Aucun de ces cas ne doit être silencieusement requalifié en zéro jeton avec un motif de fin vide.

La facture comporte une deuxième distinction. Une génération protégée peut tout de même entraîner des frais pour des tâches auxiliaires déjà exécutées, comme une recherche, l’analyse d’un fichier, l’OCR d’un PDF ou une récupération sur le Web. La politique d’OpenRouter traite ces services séparément et précise que certains cas d’échec dispensent aussi de leurs frais.[1] Une tentative d’opération avec un outil ne prouve pas qu’un frais a été facturé ; consulte le détail réel.

Par exemple, imagine une requête portant sur un document dont l’analyse s’est achevée, mais qui s’est ensuite terminée par une erreur du modèle. Un enregistrement montrant zéro frais de jetons du modèle plus des frais d’analyse pose une question différente d’un enregistrement indiquant des frais pour des jetons de modèle protégés. Il s’agit d’expliquer la limite de la politique, pas d’affirmer que ta requête sur le document a entraîné l’un ou l’autre montant.

Repère la ligne contestée avant de contacter le support. Si les frais de jetons contredisent le motif de fin admissible, fournis ces champs ensemble. Si les frais concernent l’analyse, vérifie le travail d’analyse indiqué dans l’enregistrement et la règle applicable. Une capture d’écran du total ne suffit pas à distinguer les deux.

L’utilisation de ta propre clé (BYOK) ajoute un autre compte à vérifier. OpenRouter indique que le fournisseur d’inférence facture directement les requêtes BYOK.[3] Un montant nul ou ajusté sur OpenRouter ne suffit pas, à lui seul, à établir que le fournisseur externe a annulé ses propres frais. Pour rapprocher cette requête, garde séparés la facture du fournisseur et les enregistrements OpenRouter.

Trouve les champs correspondant à l’API que tu as réellement appelée

Un client conçu pour Chat Completions peut sembler perdre des données d’usage si tu passes à Responses sans modifier les noms des champs qu’il lit. OpenRouter documente des noms différents pour les mêmes questions de comptabilisation :[4]

Ce qu’il te fautChat CompletionsResponses
Nombre d’entréesusage.prompt_tokensusage.input_tokens
Nombre de sortiesusage.completion_tokensusage.output_tokens
Nombre de jetons de raisonnementusage.completion_tokens_details.reasoning_tokensusage.output_tokens_details.reasoning_tokens
Frais du compteusage.costusage.cost

Pour le problème de quota de sortie avec Responses, examine status: "incomplete" et incomplete_details.reason: "max_output_tokens". La réponse peut contenir du raisonnement sans élément de message dans sa sortie.[2] Si tu cherches uniquement le champ message.content de Chat Completions, tu manqueras la structure reçue.

Conserve les valeurs absentes comme inconnues. Si le détail du raisonnement manque, n’insère pas zéro pour conclure que tous les jetons de sortie étaient visibles. De même, l’absence de usage.cost dans l’objet que tu as analysé peut signifier que l’analyseur l’a supprimé ; compare la réponse brute avant de décider que le service ne l’a pas fourni.

Une comparaison utile consiste à faire passer une réponse enregistrée dans le même code d’affichage, sans soumettre une autre génération. Dans cet exercice de débogage local, examine d’abord l’objet renvoyé, puis la valeur sélectionnée par ton analyseur et enfin celle transmise à l’interface. Si le texte existe dans le premier objet mais disparaît dans le deuxième, tu as localisé une perte d’information côté client. Si l’enregistrement d’origine ne contient que le schéma de budget de raisonnement décrit plus haut, modifier le composant d’affichage ne peut pas fournir une réponse qui n’a jamais été générée. Conserve l’enregistrement d’origine sans le modifier afin qu’une correction de l’affichage n’efface pas la preuve des frais.

Garde une estimation calculée localement séparée des frais déclarés. Une application peut calculer une valeur d’affichage à partir du nombre de jetons et d’une grille tarifaire stockée. Ce nombre peut être utile, mais il ne peut pas remplacer le coût déclaré de la requête. Une estimation obsolète ne doit pas écraser un zéro renvoyé, et une estimation absente ne doit pas être enregistrée comme une utilisation gratuite.

La documentation actuelle indique que l’usage complet est renvoyé automatiquement. Les anciens paramètres Chat Completions usage.include et stream_options.include_usage sont obsolètes et sans effet.[4] Les ajouter ne réparera pas un analyseur client et ne récupérera pas un événement qui ne lui est jamais parvenu.

Si le flux s’est terminé avant l’arrivée de l’enregistrement

Un flux déconnecté crée une autre lacune : l’application peut ne jamais recevoir l’événement final d’usage. OpenRouter indique que les requêtes en streaming et hors streaming ont les mêmes tarifs par jeton.[3] Le streaming change la livraison, pas le sens des données de facturation manquantes.

Enregistre l’ID de génération dès qu’il arrive. Dans les flux Responses, l’usage apparaît dans les événements terminaux completed ou incomplete. Si cet événement terminal est absent, le client ne peut pas déduire de son absence que les frais sont nuls.[4] Conserve le dernier événement effectivement reçu au lieu de fabriquer une fin réussie ou gratuite.

HTTP 200 ne suffit pas non plus. Une fois les en-têtes de réponse envoyés, une erreur peut apparaître dans le corps de la réponse ou dans le flux. OpenRouter documente les motifs de fin d’erreur dans cette situation.[5] Vérifie le contenu de l’événement, pas seulement le statut stocké par un journal HTTP.

Utilise l’ID enregistré pour récupérer les métadonnées de génération et les comparer à Activity. La requête documentée fournit les motifs de fin, les informations sur les jetons et le coût total, ainsi que des détails permettant d’identifier la génération.[6] Si l’ID n’est pas parvenu au client, conserve l’horodatage, le modèle demandé et le contexte de requête expurgé pour le support. L’enregistrement manque dans ta trace ; son coût reste à déterminer.

Pour un client de programmation qui rejette ou perd le flux, le guide sur la déconnexion du flux traite séparément le problème de livraison. Conserve les éléments de facturation pendant que tu enquêtes sur le comportement de ce client.

Vérifie les étapes précédentes avant de rejouer tout le tour

Dans une conversation utilisant des outils, le premier appel au modèle peut réussir, une action d’outil s’achever et l’explication finale échouer. À titre d’exemple hypothétique, un fichier est bien mis à jour, puis le résumé du modèle n’atteint jamais l’interface. La bulle finale vide n’annule pas la modification du fichier et ne prouve pas que toutes les requêtes du tour ont échoué.

Associe chaque ID de génération à son propre résultat et à ses propres frais. Garde le résultat de l’outil avec l’appel du modèle qui l’a demandé. Avant de rejouer le flux de travail, vérifie si l’action a déjà eu lieu. Répéter tout le tour peut créer du travail supplémentaire et rendre plus difficile la réponse à la question initiale de facturation.

Distingue aussi le basculement de fournisseur dans une requête d’une nouvelle requête soumise par ton application. Selon les informations tarifaires d’OpenRouter, les tentatives qui échouent ne sont pas facturées en jetons de modèle, tandis que les tâches auxiliaires achevées sont traitées séparément.[3] Une nouvelle requête client nécessite son propre enregistrement ; la protection de la tentative précédente ne décrit pas son résultat.

Exclus les frais d’achat de crédits de cette comparaison. Les comptes Standard et Business paient en achetant des crédits manuellement ou par recharge automatique ; les requêtes déduisent ensuite leurs coûts de ce solde. Selon OpenRouter, l’inférence utilise le tarif catalogue du fournisseur qui la sert, et la plateforme facture des frais sur les achats de crédits.[3] Pour savoir si cette route permet d’économiser sur ta charge de travail, il faut donc connaître le prix du modèle applicable et les frais de financement, et non supposer que chaque requête est remisée. Le guide tarifaire d’OpenRouter couvre cette comparaison plus large ; le montant débité sur une carte n’est pas le coût des jetons du modèle pour une génération. Pour cet incident, la question utile est précise : quelle génération, quel motif de fin et quelle ligne de facturation ne concordent pas ? Si ces enregistrements concordent mais que la réponse n’est jamais apparue, poursuis l’examen du budget de sortie, de l’analyseur de réponse ou de la gestion du flux indiqués par l’enregistrement.

Faites la même vérification sur n’importe quelle passerelle

Le budget de sortie épuisé n’est pas propre à un seul routeur. Sur reAPI, GPT-6 Sol facture les tokens de raisonnement comme des tokens de sortie, et max_completion_tokens plafonne ensemble le raisonnement et le texte visible : un budget calibré uniquement pour la réponse peut donc s’épuiser avant qu’un texte n’apparaisse. Dans une réponse en streaming, usage arrive dans le dernier bloc de données avant [DONE].[7]

Pour comparer des fournisseurs, envoyez le même prompt enregistré avec le même budget de sortie, puis lisez la raison de fin et les champs d’usage de chaque réponse, plutôt que le seul texte visible. Le catalogue des modèles liste les modèles disponibles et les tarifs actuels.

Références

  1. OpenRouter, Zero Completion Insurance : conditions d’éligibilité, couverture des jetons et exceptions pour les services auxiliaires. Consulté le 15 novembre 2026.
  2. OpenRouter, Reasoning Tokens : budgets de sortie partagés, réponses incomplètes et exclusion du raisonnement. Consulté le 15 novembre 2026.
  3. OpenRouter, Pricing : FAQ sur les tentatives échouées, le streaming et la facturation BYOK. Consulté le 15 novembre 2026.
  4. OpenRouter, Usage Accounting : champs propres à l’API, usage automatique et recherche par ID de génération. Consulté le 15 novembre 2026.
  5. OpenRouter, Errors and Debugging : sémantique des erreurs dans le corps de réponse et le streaming. Consulté le 15 novembre 2026.
  6. OpenRouter, Get request and usage metadata for a generation. Consulté le 15 novembre 2026. Les URL sources complètes et les instantanés publics sont conservés dans les archives de recherche.
  7. reAPI. Référence de l’API GPT-6 Sol. Vérifié le 17 novembre 2026. GPT-6 Sol.
Tous les guides