Responses API

POST /v1/responses

OpenAI Responses API와 호환됩니다. 구조화된 입력 항목, 도구 사용, 내장 추론을 지원합니다. gateway는 업스트림 제공업체로 투명하게 프록시합니다.

요청 본문

매개변수	유형	설명
`model`*	`string`	사용할 모델의 ID(예: gpt-5.4, gpt-5.4-mini).
`input`*	`string \| array`	텍스트 문자열 또는 입력 항목 배열(role과 content를 가진 메시지 객체).
`stream`	`boolean`	true이면 SSE 이벤트 스트림을 반환합니다. 기본값: false.
`temperature`	`number`	샘플링 온도 0–2. 기본값: 1.
`max_output_tokens`	`integer`	응답에서 생성할 최대 token 수.
`tools`	`array`	모델이 호출할 수 있는 도구 정의 목록.
`reasoning`	`object`	o 시리즈 모델을 위한 추론 구성(예: { "effort": "high" }).

요청 예시

POST /v1/responses
Authorization: Bearer YOUR_API_KEY

{
  "model": "gpt-5.4-mini",
  "input": "What is the capital of France?",
  "max_output_tokens": 256
}

응답 예시

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1714000000,
  "model": "gpt-5.4-mini",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "The capital of France is Paris." }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 9,
    "total_tokens": 21
  }
}

ℹ

Responses API는 OpenAI 모델과 상호작용하는 권장 방법입니다. 도구 사용, 구조화된 출력, 추론 구성을 기본적으로 지원합니다.