OpenAI Decisions API belgeleri

Endpoint

Bu hosta POST /api/v1/decisions gönderin. chat-completions yolu ve akış yanıtı yoktur. GET /api/v1/models model kimliğini listeler.

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

Kimlik doğrulama

Pano anahtarını Authorization: Bearer içine koyun. Eksik veya reddedilen anahtar 401 döner. Playground isteği çalıştırırken oturum hesabı için anahtar oluşturabilir.

Hızlı başlangıç

DECISIONS_API_KEY'i panelinizdeki bir anahtara ayarlayın ve aşağıdaki isteği gönderin. Yeni ziyaretçiler 2 ücretsiz çağrı alır — 2 başarılı istek için yeterli.

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 kodlama araçlarıyla kullanma

İstek sözleşmesinin tamamını içeren bir promptu kopyalayıp görevinizle birlikte Cursor, Claude Code veya ChatGPT'ye yapıştırın. Aynı referans /llms.txt adresinde.

İstek gövdesi

model, decisions-1 veya decisions-latest olur. state bir dize, JSON nesnesi veya metin dizisidir; en fazla 60.000 karakter. questions, 1 ile 6 snake_case kimliğin haritasıdır. Kimlik yalnızca yanıtınızın döndüğü etikettir, soru değildir. Asıl soruyu instructions içine 1 ile 2.000 karakterlik metin olarak yazın.

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

Soru türleri

Noul

type noul yalnızca instructions ister. noul alanı ifadenin doğru olma olasılığıdır, 0 ile 1 arası. Ayrı bir confidence alanı yoktur. Bir noul sorusunda criteria gönderirseniz bu endpoint onu yok sayar.

Choice

type choice, instructions ve criteria ister: en fazla 300 karakterlik açıklamalara eşlenen 2 ile 8 snake_case seçenek kimliğinden oluşan bir nesne. Yanıtta choice, her seçeneğin probabilities değeri ve confidence vardır.

Score

type score, en düşük önce olmak üzere 2 ile 10 düzey açıklamasından oluşan sıralı bir dizi ister. Yanıtta score, legend, probabilities ve confidence vardır.

Yanıt

Başarılı gövdede model, soru kimliklerinizle anahtarlanmış answers, input_tokens ve output_tokens içeren usage ve credits_used vardır. decisions-latest gönderseniz bile model decisions-1 bildirir. Aşağıda hızlı başlangıç isteğine örnek bir yanıt var; usage çıkarıldı.

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

Olasılıkları ve confidence’ı okumak

Noul, instructions içindeki ifadenin doğru olma olasılığıdır. Choice ve Score, her seçenek veya düzey için bir olasılık ile confidence döner.

İkinci sıra, insana devretme sinyalidir. confidence düşükse veya iki seçenek yakınsa vakayı bir kişiye verin ya da daha somut bir soru daha sorun. Bu yakın vakalara bakmadan eşiği düşürmeyin.

Limitler

OpenAI Decisions API: şu ana kadar belgelenenler

OpenAI, Decisions API'sini 2026-09-29'daki DevDay'de duyurdu: metin veya görsel bağlam, bir soru ve sonlu bir yanıt listesi alan, güven puanlı bir yanıt döndüren özelleşmiş bir GPT-6 Luna modeli. Şu an sınırlı önizlemede.

OpenAI istek şemasını, SDK metodlarını, oran limitlerini veya fiyatlandırmayı henüz yayımlamadı. Bu sayfadaki her şey bu sitenin uç noktasını belgeler — OpenAI dokümantasyonu olarak okumayın. OpenAI referansı çıktığında yukarıdaki alanlar aynı karar örüntüsünü açıklar: bağlam girer, yanıtlarınızdan biri çıkar.

Bu uç noktanın OpenAI Decisions API'den farkları

OpenAI'nin Decisions API'si sınırlı önizlemede olan ayrı bir üründür ve istek/yanıt şeması yayınlanmamıştır. Bu site aynı karar örüntüsü üzerine kurulu bağımsız bir uç nokta sunar — bir state, tipli sorular ve seçenek başına olasılıklı yanıtlar.

• Girdi: OpenAI duyurusu metin veya görsel bağlamı tanımlıyor; bu uç nokta yalnızca metin kabul eder — en fazla 60.000 karakterlik bir metin, JSON nesnesi veya metin dizisi.
• Model kimliği: decisions-1 veya decisions-latest gönderin. decisions-1.0 gibi sürümlü bir kimlik 422 döndürür.
• Yanıtlar: OpenAI bir yanıt artı güven puanı tanımlıyor; bu uç nokta her soru kimliği için bir yanıt döndürür ve her seçenek ya da düzey için olasılık verir.
• Kullanılabilirlik: OpenAI'nin Decisions API'si sınırlı önizlemede; bu uç nokta bugün paneldeki bir anahtarla çağrılabilir.
• Ücretlendirme: bu sitede başarılı çağrı başına 1 kredi, token sayısından bağımsız. OpenAI, Decisions API fiyatını yayınlamadı.

Hatalar

• 401 — API anahtarı yok veya reddedildi.
• 402 — anahtar geçerli, bakiye bu çağrıyı karşılamaz. Upstream hatası kredi kullanmaz.
• 422 — gövde doğrulamadan geçmedi. Mesaj alanı söyler.
• 429 — karar hizmeti hız sınırında. Sonra yeniden deneyin.
• 502 — hizmet yanıt döndürmedi. Kredi kullanılmaz.