OpenAI Decisions API vs Responses API

Her API'nin amacı

Responses API genel iş yüküdür: metin veya görsel gönderin, üretilmiş metin, şema uyumlu JSON veya araç çağrıları alın ve konuşmayı turlar boyunca sürdürün. Modelin yeni bir şey üretmesi gerektiğinde kullanılan uç nokta budur.

Decisions API tasarımı gereği daha dardır. Bağlam ve tanımladığınız sonlu bir yanıt kümesi içeren bir soru gönderirsiniz; o da bu yanıtlardan birini döndürür — OpenAI'nin duyurusuna göre seçenek başına olasılık ve güvenle birlikte. 2026-09-30 itibarıyla sınırlı önizlemededir; geniş sürümün önümüzdeki günlerde geleceği duyuruldu. Bu sitedeki uç nokta aynı sonlu-yanıt modelini bugün decisions-1 üzerinde çalıştırıyor.

Yan yana

Bugün Responses API ile karar vermek

Responses API ile bir kararı zaten yaklaşık olarak verebilirsiniz: çıktıyı bir JSON şeması ve enum ile kısıtlayın. Geçerli bir etiket alırsınız — ama diğer seçenekler için seçenek başına olasılık alamazsınız.

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

Aynı görev karar isteği olarak

Bu sitenin uç noktasında choice sorusu olarak ifade edildiğinde aynı yönlendirme görevi kazanan etiketi, her seçenek için olasılığı ve güveni döndürür — net vakaları otomatik yönlendirmek ve yakın vakaları eskale etmek için gereken girdiler.

// 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 }

Hangisini ne zaman kullanmalı

Modelin içerik üretmesi gerektiğinde Responses API kullanın: yanıtı taslaklayın, özeti yazın, aracı çağırın. Modelin seçim yapması gerektiğinde bir karar API'si kullanın — hangi kuyruk, hangi dal, hangi sonraki eylem — ve seçime güvenip güvenemeyeceğinize karar vermek için dağılıma ihtiyacınız olduğunda.

İyi bir şekilde birleşirler: bir karar çağrısı dalı seçer, ardından bir Responses API çağrısı o dal için yanıtı yazar. Seçmek ve yazmak farklı işlerdir.

SSS