思考(推論)の制御

推論モデルは回答の前に「思考」トークンを生成し、それは出力トークンとして課金されます。reasoning パラメータで思考の強度を指定するか、思考をオフにできます。指定しない場合の動作はモデルごとに異なり、Kimi K3 のように既定で最大強度で思考するモデルもあります。

思考トークンの課金

思考トークンは completion_tokens に含まれ、出力トークンの単価で課金されます。内訳はレスポンスの usage.completion_tokens_details.reasoning_tokens で確認できます。回答が1語でも、思考が数百トークン走れば請求はその分になります。

レスポンスの usage 例
"usage": {
  "prompt_tokens": 113,
  "completion_tokens": 43,
  "completion_tokens_details": {
    "reasoning_tokens": 26
  }
}

思考の本文は message.reasoning_content(ストリーミングでは delta.reasoning_content)に入り、回答の content とは分かれています。表示しない場合でも課金は発生します。

reasoning パラメータ

/v1/chat/completions のリクエストに reasoning オブジェクトを付けます。effort(強度)と max_tokens(思考トークンの上限)はどちらか一方を指定してください。

強度を指定する

effort には none / minimal / low / medium / high / xhigh / max を指定できます。モデルが受け付ける値は下の表を参照してください。受け付けない値を送ると 400 になります。

curl https://api.fastmetal.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "messages": [{"role": "user", "content": "..."}],
    "reasoning": {"effort": "low"}
  }'

思考をオフにする

enabled: false で思考を止めます。一問一答や分類など軽い用途では、応答が速くなりコストも下がります。常に思考するモデル(表の「オフ」が「不可」のもの)では効きません。

{
  "model": "kimi-k3",
  "messages": [{"role": "user", "content": "..."}],
  "reasoning": {"enabled": false}
}

思考トークンに上限を付ける

max_tokens で思考に使うトークン数の上限を指定します(Anthropic 形式)。effort と同時には指定できません。

{
  "model": "kimi-k3",
  "messages": [{"role": "user", "content": "..."}],
  "reasoning": {"max_tokens": 2000}
}

reasoning_effort について

OpenAI 形式の reasoning_effort(トップレベルの文字列)は、モデルによっては無視されます。2026-09-03 に kimi-k3 へ reasoning_effort: "none" を送ったところ、思考トークンが通常どおり発生しました。GPT-5 系では有効ですが、FastMetal では reasoning オブジェクトの利用を推奨します。対応しているモデルは下の表のとおりです。anthropic-claude-*、japan-*、llm-jp、gpt-oss-120b は現時点では対象外で、表にも載りません。

モデルごとの既定値

reasoning を指定しない場合の動作です。提供中のモデルのうち、思考の制御に対応しているものを表示しています。

モデル既定指定できる強度オフ
anthropic-claude-fable-5思考オン(high)
max
xhigh
high
medium
low
不可
anthropic-claude-fable-5-1思考オン(high)
max
xhigh
high
medium
low
不可
anthropic-claude-haiku-5-5思考オン(medium)
max
xhigh
high
medium
low
可
anthropic-claude-opus-4-8思考オフ
max
xhigh
high
medium
low
可
anthropic-claude-opus-5思考オン(high)
max
xhigh
high
medium
low
可
anthropic-claude-opus-5-5思考オン(high)
max
xhigh
high
medium
low
不可
anthropic-claude-sonnet-5思考オン(high)
max
xhigh
high
medium
low
可
anthropic-claude-sonnet-5-5思考オン(high)
max
xhigh
high
medium
low
不可
beam-1.0思考オン(max)
max
xhigh
high
medium
low
不可
deepseek-v4-flash思考オン(high)
xhigh
high
可
deepseek-v4-flash-0731思考オン(high)
max
high
low
可
deepseek-v4-pro思考オン(high)
xhigh
high
可
deepseek-v4.1-flash思考オン(high)
max
high
low
可
deepseek-v4.1-flash-1017思考オン(high)
max
high
low
none
可
ember-1思考オン(max)
max
high
low
可
fugu-max思考オン(high)
max
xhigh
high
不可
fugu-ultra-v2思考オン(xhigh)
max
xhigh
high
不可
gemini-3.1-pro-preview思考オン(medium)
high
medium
low
不可
gemini-3.5-flash思考オン(medium)
high
medium
low
minimal
不可
gemini-3.7-flash思考オン(medium)
high
medium
low
不可
gemini-3.8-flash思考オン(medium)
high
medium
low
不可
gemini-4-argon思考オン(medium)
high
medium
low
不可
gemma-4-26b-a4b-it思考オフ-可
glm-4.7思考オン-可
glm-4.7-flash思考オン-可
glm-5思考オン-可
glm-5.2思考オン(high)
xhigh
high
可
glm-5.3思考オン(max)
max
high
low
不可
glm-5.3-flash思考オン(max)
max
high
low
不可
glm-5.3-flashx思考オン(max)
max
high
low
不可
gpt-5-mini思考オン(medium)
high
medium
low
minimal
不可
gpt-5.4-nano思考オフ
xhigh
high
medium
low
none
可
gpt-5.6-luna思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-5.6-sol思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-5.6-terra思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6-astra思考オン(medium)
max
xhigh
high
medium
low
不可
gpt-6-astra-pro思考オン(medium)
max
xhigh
high
medium
low
不可
gpt-6-luna思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6-luna-pro思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6-sol思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6-sol-pro思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6.1-sol思考オン(medium)
max
xhigh
high
medium
low
不可
gpt-6.1-sol-pro思考オン(medium)
max
xhigh
high
medium
low
不可
gpt-6.1-terra思考オン(medium)
max
xhigh
high
medium
low
none
可
gpt-6.1-terra-pro思考オン(medium)
max
xhigh
high
medium
low
不可
gpt-oss-20b思考オン(medium)
high
medium
low
不可
grok-4.5思考オン(high)
high
medium
low
不可
grok-4.6思考オン(high)
xhigh
high
medium
low
不可
grok-4.7思考オン(high)
xhigh
high
medium
low
不可
hy3思考オン(high)
high
low
none
可
inkling思考オン(high)
max
high
medium
low
minimal
none
可
kimi-k2.6思考オン-可
kimi-k3思考オン(max)
max
high
low
可
kimi-k3.1-pro思考オン(max)
max
high
low
none
可
lfm-2.5-24b-a2b思考オン-不可
ling-3.0-flash-vl思考オン-可
mercury-2.5思考オン(medium)
high
medium
low
none
可
mercury-3思考オン(medium)
high
medium
low
none
可
minimax-m2.7思考オン-不可
mistral-large-4思考オン(high)
high
none
可
muse-glimmer-30b思考オン(medium)
xhigh
high
medium
low
不可
muse-spark-1.2思考オン(medium)
xhigh
high
medium
low
minimal
不可
muse-spark-1.3思考オン(medium)
max
xhigh
high
medium
low
minimal
不可
muse-spark-1.3-contributor思考オン(medium)
max
xhigh
high
medium
low
minimal
不可
muse-spark-open思考オン(medium)
xhigh
high
medium
low
不可
muse-wonder思考オン(medium)
max
xhigh
high
medium
low
minimal
不可
nemotron-3-super-120b-a12b思考オン(medium)
medium
low
可
qwen3.6-27b思考オン-可
qwen3.7-max思考オン-可
qwen3.8-2.4t-a95b思考オン(xhigh)
xhigh
medium
low
不可
qwen3.8-27b思考オン(xhigh)
xhigh
medium
low
可
solar-mini4思考オフ
max
xhigh
high
medium
low
minimal
none
可

表にないモデルは、思考の制御に対応していないか、カタログにまだ情報がないものです。各モデルの詳細ページの「推論設定」も同じ情報を表示します。

チャットでの設定

チャット画面では、思考を制御できるモデルを選ぶとモデル選択の横に「思考」セレクタが表示されます。既定はそのモデルが受け付ける最も低い強度で、選んだ値はブラウザに記憶されます。 チャットを開く