OpenAI Decisions API vs Responses API

Для чего нужен каждый API

Responses API — универсальная рабочая лошадка: отправляйте текст или изображения, получайте сгенерированный текст, соответствующий схеме JSON или вызовы инструментов, продолжайте диалог между ходами. Это эндпоинт для случаев, когда модель должна произвести что-то новое.

Decisions API у́же по замыслу. Вы отправляете контекст и вопрос с конечным набором ответов, который определяете сами, и он возвращает один из этих ответов — с вероятностью для каждого варианта и уверенностью, согласно анонсу OpenAI. На 2026-09-30 он в ограниченном превью, широкий релиз анонсирован на ближайшие дни. Эндпоинт этого сайта уже сегодня выполняет тот же паттерн конечного ответа на decisions-1.

Рядом друг с другом

Решение через Responses API уже сегодня

Приблизить решение через Responses API можно уже сейчас: ограничьте вывод JSON-схемой и enum. Вы получите валидную метку — но без вероятностей по остальным вариантам.

// OpenAI Responses API: ask for a label inside a JSON schema.
// You get a label — not a probability per option.
const res = await client.responses.create({
  model: "YOUR_MODEL",
  input: "The page renders blank in Safari. Route this ticket.",
  text: {
    format: {
      type: "json_schema",
      name: "route",
      strict: true,
      schema: {
        type: "object",
        properties: {
          team: { type: "string", enum: ["payments", "frontend", "account"] },
        },
        required: ["team"],
        additionalProperties: false,
      },
    },
  },
});
// res.output_text -> { "team": "frontend" }

Та же задача как запрос решения

В виде вопроса choice на эндпоинте этого сайта та же задача маршрутизации возвращает метку-победителя, вероятность для каждого варианта и уверенность — то, что нужно, чтобы автоматически маршрутизировать ясные случаи и эскалировать спорные.

// decisions-1 on this site: the same routing task as a choice question.
const res = await fetch("https://decisions-api.net/api/v1/decisions", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "decisions-1",
    state: "The page renders blank in Safari.",
    questions: {
      team: {
        type: "choice",
        instructions: "Which team should own this ticket?",
        criteria: {
          payments: "Checkout or billing.",
          frontend: "Rendering or browser behavior.",
          account: "Login or permissions.",
        },
      },
    },
  }),
});
// Illustrative response: answers.team ->
//   { choice: "frontend", probabilities: {...}, confidence: 0.86 }

Когда что использовать

Используйте Responses API, когда модель должна производить контент: написать ответ, составить сводку, вызвать инструмент. Используйте API решений, когда модель должна выбрать — какую очередь, какую ветку, какое следующее действие — и когда вам нужно распределение, чтобы понять, можно ли доверять выбору.

Они хорошо сочетаются: вызов решения выбирает ветку, затем вызов Responses API пишет ответ для этой ветки. Выбирать и писать — разные работы.

Частые вопросы