Skip to main content
Responses는 OpenAI의 네이티브 상태 유지 응답 프로토콜입니다. TokenLab는 모델 상세가 Responses 형식을 공개하고 동일 프로토콜 upstream 경로가 있을 때만 이 진입점을 제공합니다. 모델명이나 공급자명으로 추론하지 않으며 Chat Completions로 fallback하지 않습니다. 알 수 없는 필드, 명시적 null, 빈 배열을 포함한 JSON 형태를 보존해 best-effort로 전달합니다.

요청 본문

string
필수
사용할 모델의 ID입니다. 사용 가능한 옵션은 Models을 참조하세요.
string | array
재사용 가능한 prompt를 사용하거나 previous_response_id로 저장된 응답을 이어갈 때는 input을 생략할 수 있습니다.대화를 구성하는 입력 항목들의 목록입니다.각 항목은 다음 중 하나일 수 있습니다:
  • message: 역할과 내용을 가진 대화 메시지
  • function_call: 함수 호출 요청
  • function_call_output: 함수 호출의 출력
멀티모달 입력의 경우, message.content는 일반 문자열이거나 콘텐츠 블록의 배열일 수 있습니다. GPT-5.4 계열과 같이 이미지 지원 모델의 경우, URL이나 Base64 문자열을 일반 텍스트에 직접 포함시키지 말고 이미지를 input_image 블록으로 전달하세요.예시 콘텐츠 블록:
  • { "type": "input_text", "text": "Describe this image" }
  • { "type": "input_image", "image_url": "https://example.com/image.jpg" }
  • { "type": "input_image", "image_url": "data:image/png;base64,..." }
string
모델에 대한 시스템 지침(시스템 메시지와 동일).
integer
생성할 최대 토큰 수입니다.
number
기본값:"1"
샘플링 온도 (0에서 2 사이).
array
모델이 호출할 수 있는 도구 목록입니다. TokenLab는 로컬 allowlist 없이 네이티브 정의를 전달하며 지원되는 유형과 조합은 선택된 upstream이 결정합니다.
boolean
기본값:"false"
true이면 이벤트 스트림을 반환합니다.
string
대화를 이어갈 이전 응답의 ID입니다.
boolean
기본값:"true"
나중에 검색하기 위해 응답을 저장할지 여부입니다.
object
추적 목적으로 응답에 첨부할 메타데이터입니다.
object
텍스트 생성 구성 옵션입니다. text.format의 동작은 선택한 모델 및 라우팅된 경로에 따라 달라지며, 모든 모델에서 동일하게 보장되지 않습니다.
boolean
기본값:"true"
여러 도구 호출을 병렬로 허용할지 여부입니다.
number
Nucleus 샘플링 매개변수 (0-1).
object
GPT-5 계열과 같은 추론 지원 모델을 위한 추론 구성입니다.
  • effort (string): 추론 노력 수준 (low, medium, high)

응답

string
응답의 고유 식별자입니다.
string
항상 response입니다.
integer
응답이 생성된 Unix 타임스탬프입니다.
array
모델이 생성한 출력 항목들의 목록입니다.
object
토큰 사용 통계입니다.