> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 추론 모델

> 프로덕션 환경 재검토를 기반으로, Crazyrouter의 추론 기능을 사용하고 적절한 프로토콜을 선택합니다

> 업데이트: 2026-06-06

# 추론 모델

이 문서 페이지는 `2026-03-22`에 Crazyrouter 프로덕션 환경에서 재검토를 완료한 추론 동작만 기재합니다.

OpenAI 호환 연동을 진행 중이라면, 현재는 다음과 같이 이해해야 합니다:

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

## 검증된 조합

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

***

## Chat Completions: `reasoning_effort`

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

```bash cURL theme={null}
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를 직접 사용하는 것입니다:

```bash cURL theme={null}
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`:

```json theme={null}
["reasoning", "message"]
```

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

* [GPT-5 사고 모드](/ko/chat/responses/gpt5-thinking)
* [AI 사고 필드](/ko/reference/thinking)

***

## 현재 권장 사항

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

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