Skip to main content
/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_searchcode_interpreter 같은 내장 도구는 Responses에서만 사용할 수 있습니다
Chat Completions가 여전히 적합한 경우는 다음과 같습니다. 기존 프레임워크에 의존하고 있을 때(LangChain과 대부분의 클라이언트는 기본값이 /v1/chat/completions입니다), 또는 Claude, Gemini 및 다른 비-OpenAI 모델도 함께 호출하는 하나의 코드베이스를 원할 때입니다. 호환 모드를 보십시오.
중단 예정인 것은 Assistants API(2026년 8월 26일 (UTC)에 종료 예정)이지, Chat Completions가 아닙니다. 두 엔드포인트 모두 장기적으로 지원되며, 새 기능은 단순히 Responses에 먼저 적용됩니다.

빠른 시작

수동으로 작성한 output[0].content[0].text보다 response.output_text을 사용하는 것이 좋습니다 — 추론 모델에서는 output의 첫 항목이 종종 reasoning 항목이지 message 항목이 아니므로, 하드코딩된 인덱싱은 깨집니다.

요청 매개변수

gpt-5 시리즈 추론 모델은 temperature / top_p를 지원하지 않습니다 — 전달하면 오류가 발생합니다. 대신 reasoning.efforttext.verbosity를 사용하십시오.

응답 구조

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와 같은 방식입니다:
APIYI에서는 서버 측 상태를 사용할 수 없습니다 — 이에 의존하지 마십시오. 게이트웨이를 통해 테스트했습니다(여러 모델, 재시도 지연 포함):
  • previous_response_id: 오류 없이 수락됨(200 반환), 하지만 다음 턴은 이전 턴을 기억하지 못합니다(input_tokens는 현재 턴만 반영하며, 히스토리는 로드되지 않음);
  • GET /v1/responses/{id}: 400을 반환합니다 — 저장된 응답은 조회할 수 없습니다;
  • conversation 객체(/v1/conversations): 404를 반환합니다 — 지원되지 않습니다.
따라서 APIYI에서는 store / previous_response_id / conversation사용해서는 안 됩니다; 위의 “input 배열과 자체 관리 히스토리” 방식을 항상 사용하십시오. 전체 형식 간 가이드: 멀티턴 대화 가이드.
멀티턴은 input 과금을 줄이지 않습니다: 모든 턴에서 전체 히스토리를 다시 보내며, 모두 input tokens로 과금됩니다. 긴 대화는 캐시 할인으로 비용을 절감합니다(히스토리 접두사는 자동으로 0.1× 캐시 요율로 캐시 적중됩니다) — 캐시 과금을 참조하십시오.

추론 및 출력 제어

reasoning.effort 선택

text.verbosity

low / medium (기본값) / high가 답변 길이를 제어합니다. 응답 전용:

스트리밍

Responses는 Chat Completions의 일반적인 choices[0].delta 청크가 아니라 의미 기반 이벤트를 스트리밍합니다. 핵심 이벤트는 다음과 같습니다.

내장 도구

내장 도구는 Responses 전용 기능입니다. tools에 선언하면 OpenAI가 서버 측에서 이를 실행합니다: 최소한의 web_search 예시:
내장 도구는 OpenAI 측에서 실행되며, APIYI 채널에서 도구별 패스스루 지원 여부는 테스트로 확인해야 합니다. 사용자 정의 함수 호출은 완전히 지원됩니다. 함수 호출을 참조하십시오.

Pro 모델과 백그라운드 모드

gpt-5.4-progpt-5.5-pro는 전문 업무용 심층 추론 모델이며 ($30 / 백만 tokens당 $180, svip 그룹 전용), 실제로는 /v1/responses를 통해서만 사용할 수 있습니다. 단일 요청에 몇 분이 걸릴 수 있으므로 — background: true와 함께 사용하십시오:
Pro 모델은 비용이 높고 느립니다 — 그 대가는 “더 신뢰할 수 있는 답변을 기다리는 데 몇 분이 걸립니다”입니다. 일상적인 개발에는 gpt-5.4 / gpt-5.5를 사용하십시오. 분명한 심층 추론 필요가 없으면 Pro를 선택하지 마십시오.

지원 모델 및 가격

고정 날짜 버전(예: gpt-5.4-2026-03-05)도 동일한 가격으로 제공됩니다. 전체 목록: 모델 및 가격.

Chat Completions에서의 매핑

GPT-5.4부터는(gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna 포함), /v1/chat/completions에서 도구 호출과 추론을 동시에 사용할 수 없습니다: tools를 포함하면서 reasoning_effortnone가 아닌 모든 요청은(기본 medium 포함) 400으로 실패하며 — Function tools with reasoning_effort are not supported for ... in /v1/chat/completions. 이는 OpenAI의 공식 제한이며, 이 페이지에서 다루는 /v1/responses 엔드포인트에는 이러한 제한이 없습니다 — 이 모델들에서 도구 호출을 사용하려면 Responses를 사용하십시오.
/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(이 페이지)를 호스팅하고 있으므로 게이트웨이 측의 장애물은 없습니다
2026년 7월 기준의 주류 클라이언트 지원 현황: 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 제공자를 선택하십시오.

문제 해결

관련 링크

  • 이 그룹: 호환 모드 · 캐시 과금 · 함수 호출
  • token 받기 / 관리: https://api.apiyi.com/token
  • OpenAI 마이그레이션 가이드: developers.openai.com/api/docs/guides/migrate-to-responses