업데이트: 2026-06-06

​

Responses API 개요

​

현재 권장 이해

• 관찰 가능한 reasoning 출력이 필요한 경우: /v1/responses 우선 사용
• OpenAI 스타일 Web Search가 필요한 경우: /v1/responses 우선 사용
• 일반적인 채팅이나 기존 프로젝트의 연속 사용만 필요한 경우: /v1/chat/completions를 계속 사용 가능

​

Responses API vs Chat Completions API

​

최소 사용 예시

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.crazyrouter.com/v1"
)

response = client.responses.create(
    model="gpt-5.5",
    input="Explain what a REST API is in one sentence."
)

print(response.output_text)

{
  "object": "response",
  "output": [
    {
      "type": "message"
    }
  ]
}

​

Responses를 우선 선택해야 하는 경우

• gpt-5.5의 reasoning 요약을 사용하려는 경우
• 모델이 실제로 web_search_call을 트리거했는지 판단해야 하는 경우
• 더 풍부한 SSE 이벤트를 소비하려는 경우

• GPT-5 사고 모드
• Responses Web 검색
• Responses Function Calling

​

계속 Chat Completions를 사용해야 하는 경우

• 이미 안정적인 Chat Completions 연동 코드가 있는 경우
• 최종 답변에만 관심이 있고 reasoning item에는 관심이 없는 경우
• Claude, Gemini 등 OpenAI 호환 모델을 연동하는 경우