リーズニング強度(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…)	そのまま転送	そのままプロバイダーへ転送されます。例外が 1 つあり、モデルのカタログ項目が受け付けるエフォート段階を宣言している場合は、最低段階より低い値はその段階に引き上げ、最高段階より高い値は引き下げます(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 が受け付ける 3 つのレベルに収められます。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