업데이트: 2026-06-06

추론 모델

이 문서 페이지는 2026-03-22에 Crazyrouter 프로덕션 환경에서 재검토를 완료한 추론 동작만 기재합니다. OpenAI 호환 연동을 진행 중이라면, 현재는 다음과 같이 이해해야 합니다:

더 강력한 추론 능력만 필요하고 사고 요약(reasoning summary)을 볼 필요가 없다면: Chat Completions의 reasoning_effort를 사용할 수 있습니다
관찰 가능한 reasoning 출력을 안정적으로 얻어야 한다면: Responses API를 우선 사용하십시오. GPT-5 사고 모드를 참고하십시오

검증된 조합

라우팅	모델	요청 파라미터	현재 프로덕션 동작
Chat Completions	`gpt-5.5`	`reasoning_effort`	요청 성공, 최종 답변 반환
Responses	`gpt-5.5`	`reasoning.effort` / `reasoning.summary`	`output`에서 `reasoning`과 `message` item 반환

Chat Completions: `reasoning_effort`

현재 프로덕션에서 바로 사용할 수 있습니다:

cURL

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Which is larger, 9.11 or 9.9? Explain briefly."
      }
    ],
    "reasoning_effort": "high",
    "max_tokens": 120
  }'

reasoning_effort 선택 가능한 값:

값	설명
`low`	더 빠르게 반환되며, 간단한 문제에 적합합니다
`medium`	기본형 균형 설정
`high`	복잡한 추론에 더 특화되어 있습니다

현재 반환 동작

2026-03-22 프로덕션 재검토에서:

요청은 정상적으로 성공합니다
최종 답변은 message.content에 있습니다
message.reasoning_content 필드는 현재 안정적으로 유효한 콘텐츠를 제공하지 않습니다

따라서 모델의 추론 강도만 높이고 싶다면 reasoning_effort를 계속 사용할 수 있습니다. “표시되는 추론 요약 필드”에 의존해야 한다면, Chat Completions를 메인 방안으로 사용하지 마십시오.

관찰 가능한 추론 출력이 필요한 경우

현재 더 안정적인 방법은 Responses API를 직접 사용하는 것입니다:

cURL

curl https://api.crazyrouter.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "input": "Which is larger, 9.11 or 9.9? Explain briefly.",
    "reasoning": {
      "effort": "high",
      "summary": "detailed"
    }
  }'

현재 프로덕션 검증에서 반환되는 핵심 output.type:

["reasoning", "message"]

상세 예제, 요약 필드 및 스트리밍 이벤트명은 다음을 참고하십시오:

현재 권장 사항

새 프로젝트에서 추론 요약을 기록하거나 표시해야 한다면 Responses API로 시작하는 것을 우선하십시오
이미 Chat Completions에 연동되어 있고 최종 답변에만 관심이 있는 기존 프로젝트는 reasoning_effort를 계속 사용할 수 있습니다
모든 OpenAI 호환 추론 모델이 reasoning_content를 안정적으로 노출한다고 가정하지 마십시오

추론 요청은 일반적으로 지연 시간과 토큰 소비를 증가시킵니다. reasoning_effort가 높을수록 비용도 일반적으로 더 높아집니다.

Chat - OpenAI

Chat - Claude

Chat - Gemini

Chat - Responses API

이미지 생성

비디오 생성

오디오

임베딩 & 리랭킹

기타 API

레퍼런스

추론 모델

추론 모델

검증된 조합

Chat Completions: `reasoning_effort`

현재 반환 동작

관찰 가능한 추론 출력이 필요한 경우

현재 권장 사항

​추론 모델

​검증된 조합

​Chat Completions: reasoning_effort

​현재 반환 동작

​관찰 가능한 추론 출력이 필요한 경우

​현재 권장 사항

추론 모델

검증된 조합

Chat Completions: `reasoning_effort`

현재 반환 동작

관찰 가능한 추론 출력이 필요한 경우

현재 권장 사항