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 키를 공개 코드나 브라우저 프런트엔드에 넣지 마세요.

문제 해결