/v1/responses는 OpenAI의 현재 주력 네이티브 엔드포인트입니다. OpenAI의 표현을 그대로 옮기면, “Chat Completions는 계속 지원되지만, Responses는 모든 새 프로젝트에 권장됩니다.” APIYI는 이 엔드포인트를 완벽하게 지원합니다. base_url을 https://api.apiyi.com/v1로 지정하기만 하면 됩니다.
이 페이지는 OpenAI 공식 문서(developers.openai.com/api/docs, 2026년 6월 기준)를 바탕으로 합니다. 모든 예시는 바로 복사해 붙여넣을 수 있습니다.
Responses를 선택해야 하는 이유
Chat Completions와 비교하면, OpenAI는 세 가지 수치를 제시합니다.- 더 나은 추론: 같은 추론 모델이 Responses를 통해 SWE-bench에서 약 3% 더 높은 점수를 받습니다(추론 상태가 턴 간 유지됩니다)
- 더 저렴한 입력: 캐시 활용률이 Chat Completions보다 40%–80% 더 높습니다(OpenAI 내부 테스트 기준). 따라서 입력 과금이 직접 줄어듭니다
- 더 많은 도구:
web_search와code_interpreter같은 내장 도구는 Responses에서만 사용할 수 있습니다
/v1/chat/completions입니다), 또는 Claude, Gemini 및 다른 비-OpenAI 모델도 함께 호출하는 하나의 코드베이스를 원할 때입니다. 호환 모드를 보십시오.
중단 예정인 것은 Assistants API(2026년 8월 26일 (UTC)에 종료 예정)이지, Chat Completions가 아닙니다. 두 엔드포인트 모두 장기적으로 지원되며, 새 기능은 단순히 Responses에 먼저 적용됩니다.
빠른 시작
요청 매개변수
응답 구조
output는 항목 배열입니다. 세 가지 일반적인 유형은 reasoning(추론 요약), message(텍스트 응답), 그리고 function_call(함수 호출 요청)입니다. 축약 예시는 다음과 같습니다:
usage 필드는 다음과 같습니다:
input_tokens_details.cached_tokens: 캐시에 적중한 입력(0.1배로 과금)output_tokens_details.reasoning_tokens: 추론 지출(출력 요율로 과금되며,reasoning.effort으로 조정합니다)
멀티턴: 히스토리를 직접 유지하십시오
APIYI를 통해 Responses API를 호출할 때는 전체 히스토리를input 배열로 전달하십시오(각 항목은 role / content 포함), Chat Completions와 같은 방식입니다:
추론 및 출력 제어
reasoning.effort 선택
text.verbosity
low / medium (기본값) / high가 답변 길이를 제어합니다. 응답 전용:
스트리밍
Responses는 Chat Completions의 일반적인choices[0].delta 청크가 아니라 의미 기반 이벤트를 스트리밍합니다. 핵심 이벤트는 다음과 같습니다.
내장 도구
내장 도구는 Responses 전용 기능입니다.tools에 선언하면 OpenAI가 서버 측에서 이를 실행합니다:
최소한의
web_search 예시:
내장 도구는 OpenAI 측에서 실행되며, APIYI 채널에서 도구별 패스스루 지원 여부는 테스트로 확인해야 합니다. 사용자 정의 함수 호출은 완전히 지원됩니다. 함수 호출을 참조하십시오.
Pro 모델과 백그라운드 모드
gpt-5.4-pro 및 gpt-5.5-pro는 전문 업무용 심층 추론 모델이며 ($30 / 백만 tokens당 $180, svip 그룹 전용), 실제로는 /v1/responses를 통해서만 사용할 수 있습니다. 단일 요청에 몇 분이 걸릴 수 있으므로 — background: true와 함께 사용하십시오:
지원 모델 및 가격
고정 날짜 버전(예:
gpt-5.4-2026-03-05)도 동일한 가격으로 제공됩니다. 전체 목록: 모델 및 가격.
Chat Completions에서의 매핑
/v1/chat/completions에서 마이그레이션할 때의 필드 매핑:
클라이언트 지원 현황
왜 대부분의 VS Code 계열 IDE와 플러그인(Cline, Trae 등)은 이 페이지에서 다루는 Responses 엔드포인트가 아니라/v1/chat/completions만 지원합니까?
- chat/completions는 사실상의 업계 표준입니다: 서드파티 게이트웨이, 로컬 추론 런타임(Ollama / vLLM / LM Studio), 그리고 OpenAI 이외의 벤더 모두 이를 구현하므로, 하나의 핸들러로 수백 개의 제공자를 처리할 수 있습니다. 반면
/v1/responses은 여전히 본질적으로 OpenAI 전용 방언에 가깝습니다 - Responses는 URL만 바꾸는 문제가 아닙니다: 의미 기반 이벤트 스트리밍(델타 결합이 아님), 항목 기반 출력, 추론 상태 전달은 모두 chat/completions와 근본적으로 다릅니다. 클라이언트는 전체 에이전트 루프를 다시 작성해야 합니다
- 닭이 먼저냐 달걀이 먼저냐의 문제입니다: 클라이언트는 대부분의 커스텀 엔드포인트(게이트웨이)가 Responses를 제공하지 않기 때문에 구현하지 않고, 게이트웨이도 같은 이유로 서두르지 않습니다. APIYI는 이미
/v1/responses(이 페이지)를 호스팅하고 있으므로 게이트웨이 측의 장애물은 없습니다
GPT-5.4+의 “추론 + tool calling” 워크로드에는 Codex CLI / opencode가 첫 번째 선택입니다. Base URL을
https://api.apiyi.com/v1에 지정하십시오. gpt-5.4만으로 충분하고 VS Code 계열 IDE(Trae 포함)를 계속 쓰고 싶다면 Roo Code 플러그인을 설치한 뒤 OpenAI 제공자를 선택하십시오.