チャット生成モデルの仕様
[更新: 2026年11月18日]
チャット補完API( https://api.ai.sakura.ad.jp/v1/chat/completions )で利用できるチャット生成モデルの仕様と、APIの互換性について説明します。
モデルごとの仕様
モデル名 |
context 長 |
|
vision |
tool call |
reasoning |
|---|---|---|---|---|---|
|
131,072 |
32,000 |
✕ ※3 |
✓ |
✓ |
|
262,144 |
32,000 ※2 |
✓ |
✓ |
✓ |
|
4,096 |
※1 |
✕ |
✕ |
✕ |
|
4,096 |
※1 |
✕ |
✕ |
✕ |
|
40,960 |
※1 |
✕ |
✕ |
✕ |
|
262,144 |
32,000 |
✓(1リクエストあたり画像3枚まで) |
✕ |
✕ |
|
262,144 |
32,000 |
✓ |
✓ |
✓ |
|
262,144 |
32,000 ※2 |
✓ |
✓ |
✓ |
|
1,048,575 |
32,000 |
✓ |
✓ |
✓ |
|
1,048,575 |
32,000 |
✓ |
✓ |
✓ |
✓ = 対応、✕ = 非対応
※1 固定の上限はありません。「context 長 − 入力トークン数」まで指定できます。
※2 生成速度によっては、上限に達する前に処理時間の上限(約5分)で打ち切られることがあります。
※3 画像を送ってもエラーにはならず、画像は無視されます。
max_tokensの上限は指定できる最大値で、その量の生成を保証するものではありません。
API の互換性
/v1/chat/completions は、 OpenAI Chat Completions API と互換性のある API です。
各パラメータに指定できる値は、OpenAI Chat Completions API に準じます。
ただし、すべてのパラメータの互換性を保証するものではありません。挙動はモデルによって異なる場合があります。
使えるパラメータ
パラメータ |
説明 |
|---|---|
|
使うモデルの名前 |
|
会話のメッセージの配列 |
|
生成する最大トークン数 |
|
出力のランダム性 |
|
ストリーミングで返すかどうか |
|
モデルが呼び出せる関数の定義 |
|
関数を呼び出すかどうかの指定 |
|
出力の形式(JSON など) |
|
reasoning の量( reasoning の制御 を参照) |
|
モデルのチャットテンプレートに渡す値( reasoning の制御 を参照) |
OpenAI Chat Completions API との違い
エラー(400)になるもの
入力トークン数と
max_tokensの合計が context 長を超えるリクエストvision に対応していないモデルへの画像の入力(
gpt-oss-120bを除く)tool call に対応していないモデルでの
toolsの指定gpt-oss-120bでのreasoning_effort: "none"の指定
無視されるもの (エラーにはなりません)
「使えるパラメータ」にないパラメータ
例:
max_completion_tokens、top_p、top_k、stop、seed、n、logprobs出力の長さは
max_tokensで指定してください。
functions/function_call(旧形式)。tools/tool_choiceを使ってください。gpt-oss-120bに送った画像
注意事項
max_tokens
生成されるトークン数の最大値は、「context 長 − 入力トークン数」「指定した
max_tokens」「モデルごとの上限」のうち最も小さい値です。max_tokensを省略した場合も、上の最大値まで生成します。reasoning 対応モデルでは、思考の過程に使われたトークンも
max_tokensに含まれます。
処理時間の上限
1リクエストの処理時間の上限は約5分です。ストリーミングでも同じです。
長い文章を生成すると、
max_tokensの上限に達する前に打ち切られることがあります。特にpreview/gemma-4-31B-itとpreview/Kimi-K2.7-Codeで起こりやすくなっています。
reasoning の制御
思考の過程は、レスポンスの
message.reasoning(ストリーミングではdelta.reasoning)に返ります。制御の方法はモデルによって違います。
モデル名 |
既定の状態 |
無効にできるか |
制御の方法 |
|---|---|---|---|
|
有効 |
できない |
|
|
有効 |
できる |
|
|
無効 |
― |
|
|
有効 |
できない |
|
reasoning に対応していないモデルでは
reasoning_effortを指定しないでください。モデルによってはエラー(400)になったり、回答の内容が変わったりします。
preview モデル
名前が
preview/で始まるモデルは、仕様が予告なく変わったり、提供を終了したりすることがあります。