Documentation OpenAI Decisions API

Endpoint

Envoyez POST /api/v1/decisions sur cet hôte. Il n’y a pas de chemin chat-completions ni de flux. GET /api/v1/models liste l’id du modèle.

POST https://decisions-api.net/api/v1/decisions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Authentification

Placez la clé du tableau de bord dans Authorization: Bearer. Une clé absente ou refusée renvoie 401. Le playground crée une clé du compte quand vous lancez une requête.

Démarrage rapide

Définissez DECISIONS_API_KEY avec une clé de votre tableau de bord, puis envoyez la requête ci-dessous. Les nouveaux visiteurs ont 2 appels offerts, soit 2 requêtes réussies.

curl https://decisions-api.net/api/v1/decisions \
  -H "Authorization: Bearer $DECISIONS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "decisions-1",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}'

Utiliser avec des outils de codage IA

Copiez un prompt contenant le contrat de requête complet, puis collez-le dans Cursor, Claude Code ou ChatGPT avec votre tâche. La même référence se trouve dans /llms.txt.

Corps de la requête

model vaut decisions-1 ou decisions-latest. state est une chaîne, un objet JSON ou un tableau de texte, jusqu’à 60 000 caractères. questions est une map de 1 à 6 ids snake_case. L’id n’est que l’étiquette sous laquelle la réponse revient, pas une question. La vraie question va dans instructions, en texte de 1 à 2 000 caractères.

{
  "model": "decisions-1",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}

Types de question

Noul

type noul n’a besoin que d’instructions. Le champ noul est la probabilité de 0 à 1 que l’énoncé soit vrai. Il n’y a pas de champ confidence séparé. Si vous envoyez criteria sur une question noul, cet endpoint l’ignore.

Choice

type choice exige instructions et criteria : un objet de 2 à 8 ids snake_case associés à des descriptions de 300 caractères max. La réponse inclut choice, probabilities de chaque option et confidence.

Score

type score exige instructions et criteria, un tableau ordonné de 2 à 10 niveaux, le plus bas d’abord. La réponse inclut score, legend, probabilities et confidence.

Réponse

Un corps réussi a model, answers indexées par vos ids de question, usage avec input_tokens et output_tokens, et credits_used. model indique decisions-1 même si vous avez envoyé decisions-latest. Voici un exemple de réponse à la requête du démarrage rapide, usage omis.

{
  "model": "decisions-1",
  "answers": {
    "sentiment": {
      "type": "choice",
      "choice": "mixed",
      "probabilities": { "mixed": 0.79, "negative": 0.2, "positive": 0.01 },
      "confidence": 0.61
    },
    "needs_follow_up": { "type": "noul", "noul": 0.83 }
  },
  "credits_used": 1
}

Lire les probabilités et confidence

Noul est la probabilité que l’énoncé dans instructions soit vrai. Choice et Score renvoient une probabilité par option ou niveau, plus confidence.

Le second est le signal pour passer à une personne. Quand confidence est bas ou que deux options sont proches, envoyez le cas à une personne ou posez une question plus précise. Ne baissez pas le seuil avant d’avoir regardé ces cas serrés.

Limites

Decisions API d'OpenAI : ce qui est documenté pour l'instant

OpenAI a annoncé sa Decisions API au DevDay du 2026-09-29 : un modèle GPT-6 Luna spécialisé qui prend un contexte texte ou image, une question et une liste finie de réponses, puis renvoie une réponse avec confiance. Elle est en aperçu limité.

OpenAI n'a pas publié son schéma de requête, ses méthodes SDK, ses limites ni ses tarifs. Tout ce qui figure sur cette page documente l'endpoint de ce site — ne le lisez pas comme de la documentation OpenAI. Quand OpenAI publiera sa référence, les champs ci-dessus décrivent le même motif : contexte en entrée, l'une de vos réponses en sortie.

Différences entre cet endpoint et l'OpenAI Decisions API

La Decisions API d'OpenAI est un produit distinct en aperçu limité, dont le schéma de requête et de réponse n'est pas publié. Ce site sert un endpoint indépendant construit sur le même motif de décision — un state, des questions typées et des réponses avec probabilités par option.

• Entrée : l'annonce d'OpenAI décrit un contexte texte ou image ; cet endpoint n'accepte que du texte — une chaîne, un objet JSON ou un tableau de texte jusqu'à 60 000 caractères.
• Id de modèle : envoyez decisions-1 ou decisions-latest. Un id versionné comme decisions-1.0 renvoie 422.
• Réponses : OpenAI décrit une réponse plus un score de confiance ; cet endpoint renvoie une réponse par id de question, avec une probabilité pour chaque option ou niveau.
• Disponibilité : la Decisions API d'OpenAI est en aperçu limité ; cet endpoint est appelable dès aujourd'hui avec une clé du tableau de bord.
• Facturation : 1 crédit par appel réussi sur ce site, quel que soit le nombre de tokens. OpenAI n'a pas publié le tarif de la Decisions API.

Erreurs

• 401 — clé absente ou refusée.
• 402 — la clé est valide et le solde ne couvre pas l’appel. Un échec amont n’utilise pas de crédit.
• 422 — le corps a échoué à la validation. Le message nomme le champ.
• 429 — le service de décision est limité. Réessayez plus tard.
• 502 — le service n’a pas renvoyé de réponses. Aucun crédit n’est utilisé.