리즈닝 강도(reasoning effort)

reasoning_effort는 모델이 답하기 전에 얼마나 생각할지를 제한합니다. 기본값이 무제한 추론인 모델에서는 가장 큰 단일 비용 지렛대이며, 실제 효과는 해당 모델이 어느 업스트림에서 돌아가는지에 전적으로 달려 있습니다.

값

요청 본문에 다음 중 하나를 보냅니다. 강도가 높을수록 과금되는 추론 토큰이 늘고 응답은 느려집니다:

minimal · low · medium · high

요청 예시

curl https://synthorai.io/v1/chat/completions \
  -H "Authorization: Bearer $SYNTHORAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "Refactor this function."}],
    "reasoning_effort": "low"
  }'

업스트림별 실제 동작

게이트웨이는 여러분에게는 한 가지 프로토콜을, 각 공급사에는 다른 프로토콜을 사용합니다. 이 표는 이 파라미터가 나갈 때 무엇으로 바뀌는지를 - 폐기되는 경우까지 포함해 - 명시합니다.

호출 대상	업스트림	동작	설명
`/v1/chat/completions`	OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…)	그대로 전달	보낸 그대로 공급사로 전달되며, 예외가 하나 있습니다. 모델의 카탈로그 항목이 허용하는 추론 강도 단계를 선언한 경우, 가장 낮은 단계보다 낮은 값은 그 단계로 올리고 가장 높은 단계보다 높은 값은 낮춥니다(GPT-6.1 Sol은 추론을 끌 수 없으므로 none과 minimal은 low로 실행됩니다). 그 밖에는 게이트웨이가 값을 검증하지 않으며 공급사가 이를 따른다고 보장하지도 않습니다. 흔히 minimal, low, medium, high를 쓰지만 허용 범위는 공급사가 정합니다(OpenAI는 대부분의 모델에서 none도, GLM은 max까지 받습니다).
`/v1/chat/completions`	Google Vertex - Gemini 4	변환	Gemini의 `thinkingLevel`로 변환되며, Gemini 4 Argon이 받는 세 단계 안으로 맞춰집니다. none과 minimal은 low로 실행되고(이 모델은 사고를 끌 수 없습니다), low/medium/high는 그대로 대응되며, xhigh와 max는 high로 실행됩니다. 요청에 명시적인 `google.thinking_config`가 있으면 그쪽이 우선합니다.
`/v1/chat/completions`	Google Vertex - Gemini 3.x	변환	Gemini의 `thinkingLevel`로 변환됩니다. none과 minimal은 모두 minimal로, low/medium/high는 그대로 대응됩니다. 요청에 명시적인 `google.thinking_config`가 있으면 그쪽이 우선합니다.
`/v1/chat/completions`	Google Vertex - Gemini 2.5	폐기	Gemini 2.5는 `thinkingBudget`만 이해하고 `thinkingLevel`은 거부하므로, 게이트웨이는 둘 다 보내지 않고 모델의 기본 사고 동작을 유지합니다. 2.5를 제어하려면 `google.thinking_config`의 `thinking_budget`을 사용하세요.
`/v1/chat/completions`	Anthropic (Claude)	변환	모델이 받아들이는 형태의 Anthropic `thinking`으로 변환됩니다. 적응형 사고만 지원하는 Claude 모델(Claude Opus 4.7 이후, Sonnet 5 이후, Haiku 5.5)에서는 low/medium/high/xhigh/max가 `thinking:{"type":"adaptive"}`가 되고 같은 수준이 `output_config.effort`에 들어갑니다. minimal은 low로 처리합니다. none은 모델 고유의 형태로 사고를 끕니다: 대부분은 `{"type":"disabled"}`, Sonnet 5.5는 `{"type":"between_tools"}`, 사고를 끌 수 없는 Opus 5.5는 low 적응형으로 실행됩니다. 그 밖의 값은 전달되지 않습니다. 그 이전 Claude 모델에서는 예산으로 변환됩니다: none과 minimal은 사고를 끄고(`{"type":"disabled"}`), low/medium/high/xhigh/max는 각각 2,048 / 8,192 / 16,384 / 32,768 토큰 예산이 됩니다(반대 방향 버킷 매핑의 역매핑). 도출된 예산은 `max_tokens` 미만으로 조정되며, `max_tokens`가 Anthropic의 최소값 1,024 토큰에 못 미치면 전송하지 않습니다. 따라서 effort를 지정해도 잘 동작하던 요청이 업스트림 400이 되지 않습니다.
`/v1/messages`	OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…)	변환	확장 사고가 켜져 있고 예산이 0보다 클 때 `thinking.budget_tokens`에서 구간별로 도출됩니다: 2,048 이하는 low, 8,192 이하는 medium, 그 이상은 high. 예산이 0이거나 없으면 아무것도 보내지 않습니다. 카탈로그 항목에 허용 추론 강도 단계를 선언한 모델(GPT-6.1 Sol)은 대신 요청의 의도를 따릅니다. thinking이 disabled 또는 between_tools이면 output_config.effort가 함께 지정되어 있어도 가장 낮은 단계(low)로 실행하고, 그 밖에는 output_config.effort를 그대로 추론 강도로 보냅니다.
`/v1/responses`	OpenAI-compatible (GPT, GLM, DeepSeek, Qwen, Kimi…)	변환	Responses API의 `reasoning.effort` 객체에서 읽어 평면 `reasoning_effort` 필드로 전송합니다.

각 행은 이를 구현한 컨버터에서 그대로 옮겨졌고 Go 테스트로 고정되어 있습니다. 따라서 빌드를 깨뜨리지 않고 이 표가 실제 게이트웨이와 어긋날 수 없습니다.

비용 영향

추론 토큰은 출력 토큰으로 과금됩니다. 기본이 무제한 추론인 모델에서는 강도를 명시하는지 여부가 같은 답변에 대해 몇 센트와 몇 달러의 차이가 됩니다. 기본값을 정하기 전에 직접 프롬프트로 측정하세요.

리즈닝 지원 모델

다음 모델은 리즈닝 모드를 문서화합니다. 해당 업스트림에서 파라미터가 어떻게 처리되는지는 각 모델 페이지를 참고하세요:

ByteDance-Seed-1.8 · Dola-Seed-2.0-lite · Dola-Seed-2.0-mini · Dola-Seed-2.0-pro · claude-fable-5 · claude-fable-5-1 · claude-haiku-4-5 · claude-haiku-5-5 · claude-opus-4-5 · claude-opus-4-6 · claude-opus-4-7 · claude-opus-4-8 · claude-opus-5 · claude-opus-5-5 · claude-sonnet-4-5 · claude-sonnet-4-6 · claude-sonnet-5 · claude-sonnet-5-5 · deepseek-v4-flash · deepseek-v4-flash-0731 · deepseek-v4-pro · deepseek-v4-pro-0813 · deepseek-v4.1-flash · deepseek-v4.1-flash-1017 · gemini-2.5-flash · gemini-2.5-flash-lite · gemini-2.5-flash-native-audio · gemini-2.5-pro · gemini-3-flash-preview · gemini-3-pro-image · gemini-3-pro-image-preview · gemini-3.1-flash-image · gemini-3.1-flash-image-preview · gemini-3.1-flash-lite-image · gemini-3.1-flash-lite-preview · gemini-3.1-flash-live · gemini-3.1-pro-preview · gemini-3.5-flash · gemini-3.5-flash-lite · gemini-3.6-flash · gemini-3.7-flash · gemini-3.8-flash · gemini-4-argon · gemini-nano-banana-2.1 · glm-5 · glm-5-turbo · glm-5.1 · glm-5.2 · glm-5.3 · glm-5.3-flash · gpt-5.2 · gpt-5.2-codex · gpt-5.3-codex · gpt-5.4 · gpt-5.4-mini · gpt-5.4-nano · gpt-5.4-pro · gpt-5.5 · gpt-5.5-pro · gpt-5.6 · gpt-5.6-luna · gpt-5.6-sol · gpt-5.6-terra · gpt-6-astra · gpt-6-luna · gpt-6-sol · gpt-6.1-sol · gpt-6.1-terra · kimi-k2.5 · kimi-k2.7-code · kimi-k3 · minimax-m3 · qwen3-max · qwen3-vl-flash · qwen3-vl-plus · qwen3.5-flash · qwen3.5-plus · qwen3.6-35b-a3b · qwen3.6-flash · qwen3.7-max · qwen3.7-plus · qwen3.8-flash · qwen3.8-max

요청 본문 전체 레퍼런스: Chat Completions