OpenAI Decisions API 문서

엔드포인트

이 호스트에 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는 snake_case id 1~6개의 맵입니다. 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 필드는 없습니다. noul 질문에 criteria를 보내면 이 엔드포인트는 무시합니다.

Choice

type choice는 instructions와 criteria가 필요합니다. snake_case 선택지 id 2~8개를 최대 300자 설명에 매핑한 객체입니다. 답에는 choice, 모든 선택지의 probabilities, confidence가 있습니다.

Score

type score는 instructions와 낮은 순서의 단계 설명 2개에서 10개가 필요합니다. 답에는 score, 단계 legend, 확률, confidence가 있습니다.

응답

성공 본문에는 model, 질문 id가 키인 answers, input_tokens와 output_tokens를 가진 usage, credits_used가 있습니다. decisions-latest를 보내도 model은 decisions-1을 보고합니다. 아래는 quickstart 요청에 대한 응답 예시로, 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는 2026-09-29 DevDay에서 Decisions API를 발표했습니다: GPT-6 Luna 특화 버전이 텍스트 또는 이미지 컨텍스트, 질문, 유한한 답변 목록을 받아 신뢰도와 함께 답변을 반환합니다. 현재 제한된 프리뷰입니다.

OpenAI는 요청 스키마, SDK 메서드, 레이트 제한, 가격을 아직 공개하지 않았습니다. 이 페이지의 모든 내용은 이 사이트의 엔드포인트를 설명하며 OpenAI 문서로 읽지 마세요. OpenAI 레퍼런스가 나와도 위 필드는 같은 의사결정 패턴을 설명합니다: 컨텍스트를 넣으면 당신의 답변 중 하나가 나옵니다.

이 엔드포인트와 OpenAI Decisions API의 차이

OpenAI의 Decisions API는 제한된 프리뷰의 별도 제품이며 요청/응답 스키마가 공개되지 않았습니다. 이 사이트는 같은 의사결정 패턴으로 만든 독립 엔드포인트를 제공합니다 — 상태, 타입이 있는 질문, 선택지별 확률이 포함된 답변.

• 입력: OpenAI 발표는 텍스트 또는 이미지 컨텍스트를 설명합니다; 이 엔드포인트는 텍스트만 받습니다 — 문자열, JSON 객체 또는 텍스트 배열, 최대 60,000자.
• 모델 ID: decisions-1 또는 decisions-latest를 보내세요. decisions-1.0 같은 버전 ID는 422를 반환합니다.
• 답변: OpenAI는 답변 하나와 신뢰도 점수를 설명합니다; 이 엔드포인트는 질문 ID마다 답변을 반환하고 모든 선택지 또는 단계에 확률을 제공합니다.
• 가용성: OpenAI의 Decisions API는 제한된 프리뷰입니다; 이 엔드포인트는 대시보드의 키로 오늘 바로 호출할 수 있습니다.
• 과금: 이 사이트에서는 성공 호출 1회당 크레딧 1개(토큰 수 무관). OpenAI는 Decisions API 가격을 공개하지 않았습니다.

오류

• 401 — API 키가 없거나 거부됨.
• 402 — 키는 유효하지만 잔액이 부족합니다. 업스트림 실패는 크레딧을 쓰지 않습니다.
• 422 — 본문 검증 실패. 메시지가 필드를 가리킵니다.
• 429 — 결정 서비스가 제한되었습니다. 나중에 다시 시도하세요.
• 502 — 결정 서비스가 답을 반환하지 않았습니다. 크레딧은 사용되지 않습니다.