Skip to content

Reasoning 모드

지원 모델은 reasoning_effort 또는 동등한 값으로 사고 강도를 조절합니다. 단계는 모델마다 다르며 강할수록 보통 시간과 토큰이 늘어납니다.

  • 카탈로그에서 지원 여부와 공식 단계 이름을 확인하세요.
  • 모든 모델에 low, medium, high가 있다고 가정하지 마세요.
  • 충분한 최저 단계부터 usage, 지연, 품질을 비교하세요.

전체 예제

원본 가이드의 실행 가능한 예제를 모두 아래에 보존했습니다. 사용 중인 도구와 운영체제에 해당하는 블록만 실행하세요.

json
"usage": {
  "prompt_tokens": 179,
  "completion_tokens": 545,          // total output — this is what's billed
  "completion_tokens_details": {
    "reasoning_tokens": 445          // of which, spent on reasoning
  }
}
bash
curl https://nordrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 4000,
    "reasoning": { "effort": "high" },
    "messages": [{ "role": "user", "content": "A hard problem…" }]
  }'

공식 문서 및 관련 링크

ParameterWhat it does
reasoning.effortReasoning depth: "low" / "medium" / "high". Lower effort — fewer reasoning tokens, cheaper responses
reasoning.max_tokensToken budget for reasoning (Anthropic style). Must be lower than the request's max_tokens
reasoning.enabled: falseTurn reasoning off (where the model supports it)
reasoning.exclude: trueHide the reasoning text from the response. Does not save money — the model still thinks and the tokens are billed
ModelBehavior
anthropic/claude-sonnet-5Doesn't reason by default. effort and max_tokens enable thinking, enabled: false genuinely disables it
anthropic/claude-fable-5Thinks adaptively — decides on its own how much. reasoning.* parameters are not supported (returns 400); control depth with output_config: { "effort": "low" | "medium" | "high" }
openai/gpt-5.4, gpt-5.5Reason by default; reasoning_effort scales the depth
x-ai/grok-4.3Reasons by default and generously (hundreds of tokens); effort: "low" cuts it down noticeably
deepseek/deepseek-r1, z-ai/glm-5.xAlways think: "disabling" only hides the text, reasoning tokens are still billed

관련 가이드

먼저 최소 텍스트 요청으로 연결을 확인한 다음 스트리밍, 도구 호출, 이미지와 같은 고급 기능을 추가하세요. API 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.

문제 해결