Decisions API : l'API d'OpenAI qui classe et tranche

La Decisions API est une API d’OpenAI qui évalue du texte, des images ou les deux, et renvoie une réponse courte : une probabilité, un choix dans une liste ou une note. Selon OpenAI, elle tourne environ dix fois plus vite que la Responses API. Elle est en bêta publique, avec un seul modèle pour l’instant, et OpenAI a ramené en parallèle ses paliers payants de cinq à trois.

En bref

• Trois types de réponses : probabilité oui/non, choix dans une liste, note sur une échelle.
• Environ dix fois plus rapide que la Responses API, selon OpenAI.
• 0,10 $ par million de tokens en entrée, sortie gratuite, seul gpt-6-luna est géré.
• Bêta publique, disponibilité générale annoncée dans les prochaines semaines.
• Paliers payants de l’API ramenés de cinq à trois : Build, Launch et Grow.

Ce que fait la Decisions API

La Decisions API sert à faire trancher un modèle plutôt qu’à lui faire rédiger un texte. Tu lui fournis un contenu (du texte, des images ou un mélange) et une ou plusieurs questions. Elle renvoie des réponses typées, que ton application peut exploiter directement pour classer un contenu, router une demande ou prioriser du travail.

OpenAI la distingue de la Responses API : la Decisions API convient quand l’application attend l’un de ces types de réponse. Pour produire un objet qui suit ton propre schéma JSON, ou pour demander un appel d’outil, la documentation renvoie vers les sorties structurées et l’appel de fonctions de la Responses API.

Les trois types de questions : oui/non, choix, note

Une requête compte trois parties : le model, l’input (les éléments à examiner, sous forme de texte ou de messages contenant texte et images) et les questions. Chaque question reçoit un name unique, que l’API reprend dans la réponse, dans un tableau answers.

Le type predicate vérifie une condition et renvoie une probabilité de 0 à 1 qu’elle soit vraie. Le type choice sélectionne une valeur parmi celles que tu fournis, avec la probabilité de chaque option et un champ confidence. Le type score note l’entrée selon des niveaux ordonnés : le résultat est la moyenne, pondérée par les probabilités, des indices de niveau, ce qui peut donner une note située entre deux niveaux.

• predicate : une condition, comme un dégât visible ou la pertinence d’un passage
• choice : une catégorie sans ordre, comme un service ou un type de contenu
• score : une échelle ordonnée, comme la gravité d’un problème

Détecter un dégât sur une photo ou trier des demandes clients

Les cas d’usage cités par OpenAI sont la détection de dégâts sur des photos, le routage automatique de demandes clients et le classement de documents. La documentation en donne des exemples : une question predicate demande si un produit présente une fissure, une déchirure ou un choc, en ignorant les ombres et les dégâts sur l’emballage. La probabilité renvoyée sert à signaler les photos à vérifier selon un seuil que tu choisis.

Pour router une plainte, une question choice propose par exemple les valeurs billing, technical, shipping et other, chacune avec une description. La documentation recommande d’ajouter une option de repli comme other quand les catégories ne couvrent pas tous les cas, afin d’orienter ces résultats vers une file de revue générale. Une question score peut, elle, noter la gravité d’un problème à partir de niveaux que tu définis, du plus bas au plus haut.

Utiliser la Decisions API : point d’accès et limites

L’API s’appelle par le point d’accès dédié POST /v1/decisions. La documentation fournit des exemples en curl, JavaScript, Python, Go, Java et Ruby, avec des versions minimales de SDK : Python 3.26.0, JavaScript 7.30.0, Go 3.73.0, Ruby 0.101.0 et Java 4.78.0. Un Playground permet d’essayer des questions et des entrées avant d’écrire du code.

Côté images, elles doivent être envoyées en base64 dans une URL de données. Les adresses HTTP ou HTTPS hébergées et les entrées par file_id ne sont pas prises en charge par ce point d’accès. Une réponse peut aussi être de type refus (refusal), que le code doit prévoir. D’après The Decoder, la Decisions API accepte la rétention zéro des données et un usage conforme HIPAA aux États-Unis et en Europe.

Prix et disponibilité de la Decisions API

Selon The Decoder, qui relaie l’annonce du 7 octobre 2026, la Decisions API est en bêta publique et OpenAI prévoit la disponibilité générale dans les prochaines semaines. Seul gpt-6-luna est géré à ce stade. Le tarif est de 0,10 $ par million de tokens en entrée, et les tokens de sortie sont gratuits.

La documentation ne donne pas de date précise pour la disponibilité générale, ni de calendrier pour d’autres modèles.

Paliers payants de l’API ramenés à trois

L’autre annonce concerne l’organisation des comptes. OpenAI a ramené ses paliers payants de cinq à trois : Build, Launch et Grow. Une organisation passe automatiquement au palier suivant quand ses achats de crédits cumulés atteignent le seuil correspondant.

Les limites d’usage mensuelles s’établissent à 500 $, 5 000 $ et 200 000 $. The Decoder présente aussi la Decisions API comme une réponse probable à la mini-tendance des « modèles de décision » lancée mi-septembre par Jev, une lecture du média et non une déclaration d’OpenAI.

Quelques repères

• token : Un token est un petit morceau de texte (un mot, une partie de mot ou un signe) que les modèles de langage utilisent pour lire et écrire. Les services d’IA facturent souvent selon le nombre de tokens traités.
• API : Une API est une interface qui permet à un programme d’envoyer des requêtes à un service et d’en recevoir les réponses, sans passer par un site web.

Questions fréquentes

Combien coûte la Decisions API d’OpenAI ?

La Decisions API coûte 0,10 $ par million de tokens en entrée, et les tokens de sortie sont gratuits, selon The Decoder. Ce tarif vaut pour gpt-6-luna, le seul modèle géré pour l’instant.

La Decisions API peut-elle analyser des images ?

Oui, la Decisions API évalue du texte, des images ou les deux. Les images doivent être envoyées en base64 dans une URL de données : les adresses hébergées et les file_id ne sont pas acceptés.

Quelles réponses la Decisions API renvoie-t-elle ?

La Decisions API renvoie trois types de réponses : une probabilité de 0 à 1 qu’une condition soit vraie, un choix parmi des valeurs fournies, ou une note selon des niveaux ordonnés. Une réponse peut aussi être un refus.

La Decisions API est-elle déjà disponible pour tous ?

Elle est en bêta publique, et OpenAI prévoit la disponibilité générale dans les prochaines semaines. La documentation ne donne pas de date exacte.

À retenir

La Decisions API remplace une réponse rédigée par un verdict chiffré (probabilité, choix ou note), pour 0,10 $ par million de tokens en entrée et des sorties gratuites. Elle reste en bêta publique, limitée à gpt-6-luna, avec une disponibilité générale annoncée sans date précise.