Документация OpenAI Decisions API

Endpoint

Отправьте POST /api/v1/decisions на этот хост. Нет пути chat-completions и нет потока. GET /api/v1/models перечисляет id модели.

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

Аутентификация

Положите ключ панели в Authorization: Bearer. Отсутствующий или отклонённый ключ даёт 401. Песочница создаёт ключ аккаунта при запуске.

Быстрый старт

Установите DECISIONS_API_KEY в ключ из вашей панели и отправьте запрос ниже. Новым посетителям доступны 1 бесплатный вызов — этого хватит на 1 успешный запрос.

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?"
    }
  }
}'

Использование с AI-инструментами для кода

Скопируйте промпт с полным контрактом запроса и вставьте его в Cursor, Claude Code или ChatGPT вместе с вашей задачей. Тот же справочник находится в /llms.txt.

Тело запроса

model — decisions-1 или decisions-latest. state — строка, JSON-объект или массив текста, до 60 000 символов. questions — карта из 1–6 id в snake_case. id — только метка, под которой возвращается ответ, а не вопрос. Сам вопрос пишите в instructions текстом от 1 до 2 000 символов.

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

Типы вопросов

Noul

type noul требует только instructions. Поле noul — вероятность от 0 до 1, что утверждение истинно. Отдельного поля confidence нет. Если отправить criteria в вопросе noul, этот endpoint его игнорирует.

Choice

type choice требует instructions и criteria: объект из 2–8 id в snake_case с описаниями до 300 символов. Ответ включает choice, probabilities каждого варианта и confidence.

Score

type score требует instructions и criteria — упорядоченный массив из 2–10 уровней, от низшего. Ответ включает score, legend, probabilities и confidence.

Ответ

Успешное тело содержит model, answers по вашим id вопросов, usage с input_tokens и output_tokens, и credits_used. model сообщает decisions-1, даже если вы отправили decisions-latest. Ниже — пример ответа на запрос из быстрого старта, usage опущено.

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

Как читать вероятности и confidence

Noul — вероятность того, что утверждение в instructions истинно. Choice и Score возвращают вероятность каждого варианта или уровня, плюс confidence.

Второй вариант — сигнал передать человеку. Когда confidence низкий или два варианта близки, отдайте случай человеку или задайте ещё один конкретный вопрос. Не снижайте порог, пока не посмотрите эти близкие случаи.

Лимиты

OpenAI Decisions API: что известно на данный момент

OpenAI анонсировала свою Decisions API на DevDay 2026-09-29: специализированная модель GPT-6 Luna принимает текстовый или графический контекст, вопрос и конечный список ответов и возвращает ответ с оценкой уверенности. Сейчас это ограниченный предпросмотр.

OpenAI пока не опубликовала схему запроса, методы SDK, лимиты или цены. Всё на этой странице описывает эндпоинт этого сайта — не читайте это как документацию OpenAI. Когда выйдет справка OpenAI, поля выше будут описывать тот же паттерн: на вход контекст, на выход один из ваших ответов.

Чем этот эндпоинт отличается от OpenAI Decisions API

Decisions API от OpenAI — отдельный продукт в ограниченном предпросмотре, его схема запроса и ответа не опубликована. Этот сайт обслуживает независимый эндпоинт, построенный на том же паттерне решений — state, типизированные вопросы и ответы с вероятностями по вариантам.

• Ввод: анонс OpenAI описывает текстовый или графический контекст; этот эндпоинт принимает только текст — строку, JSON-объект или массив текста до 60 000 символов.
• ID модели: отправляйте decisions-1 или decisions-latest. Версионный ID вроде decisions-1.0 вернёт 422.
• Ответы: OpenAI описывает один ответ с оценкой уверенности; этот эндпоинт возвращает ответ на каждый id вопроса с вероятностью для каждого варианта или уровня.
• Доступность: Decisions API от OpenAI в ограниченном предпросмотре; этот эндпоинт можно вызывать уже сегодня ключом из панели.
• Оплата: 1 кредит за успешный вызов на этом сайте независимо от числа токенов. OpenAI не публиковала цены на Decisions API.

Ошибки

• 401 — ключ отсутствует или отклонён.
• 402 — ключ верный, баланса не хватает. Сбой upstream не списывает кредит.
• 422 — тело не прошло проверку. Сообщение называет поле.
• 429 — сервис решений ограничен. Повторите позже.
• 502 — сервис не вернул ответы. Кредит не списывается.