Skip to main content
POST

인증

Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

본문

application/json
model
string
필수
예시:

"gpt-5.5"

input
필수

Responses 입력입니다. 문자열일 수도 있고, message / tool-result 항목 배열일 수도 있습니다.

instructions
string

시스템 또는 개발자 지침입니다.

max_output_tokens
integer

추론과 최종 답변을 합친 최대 토큰 수입니다. 모델별 제한이 적용되며 예산 소진 시 답변이 불완전할 수 있습니다.

필수 범위: x >= 1
temperature
number
필수 범위: 0 <= x <= 2
top_p
number
필수 범위: 0 <= x <= 1
reasoning
object
text
object
tools
object[]

Responses tools로, function tools와 web_search_preview 등 내장 도구를 포함합니다.

tool_choice
stream
boolean

true이면 OpenAI Responses SSE 이벤트를 반환합니다.

metadata
object
reasoning_effort
enum<string>

reasoning.effort의 호환 별칭입니다. 두 형식을 함께 지정하면 값이 같아야 하며, 충돌 시 400을 반환합니다. 추론 강도입니다. 이 열거형은 문법상 허용 값이며 모든 모델의 지원을 보장하지 않습니다. 미지원 값은 400을 반환합니다. Kimi K3는 low, high, max를, GPT-5.4/5.5는 none, low, medium, high, xhigh를 지원합니다. Claude와 Gemini 제한은 /ko/models/chat-models를 참고하세요. 생략하면 모델 기본 동작을 유지합니다. 모델별 지원 값, 기본값, 추론 비활성화 가능 여부는 GET /v1/models의 capability_metadata.reasoning에 공개됩니다.

사용 가능한 옵션:
none,
minimal,
low,
medium,
high,
xhigh,
max

응답

OpenAI 호환 Responses 응답입니다.

id
string
필수
object
string
필수
예시:

"response"

status
string
필수
model
string
필수
output
object[]
필수
created_at
integer
output_text
string
usage
object