Qwen のパラメーターとプロトコルの違い
互換プロトコルにおける Qwen のパラメーターの違いと使い方を確認します。
Qwen は本ページに従ってパラメーターを調整してください。完全な構造は Chat Completions、Responses、Messages を参照してください。
| モデル | 適用範囲 |
|---|
| qwen3.8-max-0902、qwen3.8-flash、qwen3.8-max | すべて Chat、Responses、Messages 対応。共通ルールをまとめ、メディア範囲は下表に記載 |
| フィールド | 差分の説明 |
|---|
enable_thinking、reasoning_effort | 思考は既定で有効。実効深度は low/medium/xhigh、既定値 xhigh。minimal→low、high/max→xhigh に変換し、none は思考無効 |
thinking_budget | reasoning_effort と併用するとエラー。深度だけ指定した場合、low/medium/xhigh はそれぞれ思考予算 4096/16384/262144 に対応 |
max_tokens、max_completion_tokens | max_tokens は最終回答のみを制限し、廃止予定。新規接続は思考と回答の合計を制限する max_completion_tokens を使用 |
temperature | 範囲 [0,2)。思考時の既定値は文字入力 1.0、画像入力 0.6。0.6 未満は 0.6 として処理。非思考時は 0.7 |
top_p、top_k | top_p の範囲は (0,1]、思考／非思考の既定値は 0.95/0.8。拡張 top_k は非負整数で既定値 20。null または 100 超で Top-K 無効 |
repetition_penalty | Qwen 拡張。0 より大きく、既定値は 1.0。OpenAI の二つのペナルティとは異なる |
preserve_thinking | 既定で有効。assistant の reasoning_content に思考を完全再送し、content に混入しない。思考未送信だけではエラーにならない |
tool_choice | auto/none に対応。思考時は required と関数強制指定が不可。非思考時は関数指定可能だが、required でも呼び出しを保証しない |
tool_stream | 既定値 false。stream=true の場合のみ複雑な引数を逐次出力。Max は文字のみ、Flash は全モダリティ |
response_format | json_object/json_schema に対応。前者はプロンプトに JSON の語が必要。後者は response_format.json_schema で構造を定義。思考を無効にする必要なし |
enable_search、search_options | enable_search の既定値 false。search_options.forced_search は検索を強制。対象モデルは turbo/max 戦略を使用。include_tool_usage=true で検索統計を usage.x_tools に返す |
| フィールド | 差分の説明 |
|---|
reasoning.effort | none/low/medium/xhigh に対応、既定値 xhigh。minimal→low、high/max→xhigh |
enable_thinking | 互換スイッチは今後廃止予定で、公式は reasoning.effort を推奨。併用時は reasoning.effort 優先 |
max_output_tokens | 最小 16。思考と最終回答を含む |
text.format | text/json_object/json_schema に対応。JSON Schema は text.format.json_schema 内に name/schema/strict を指定し、原版の平坦構造とは異なる |
tool_choice | auto/none/required と allowed_tools オブジェクトに対応。required はツール一覧が一つの場合のみ使用可能 |
tools | 関数以外に web_search、web_extractor、code_interpreter などを使用可能。ウェブ取得は検索と併用し、コード実行には思考が必要 |
store、previous_response_id、conversation | サーバー側履歴に対応。store の既定値は true、応答 ID は 7 日間 有効。後二つは併用不可 |
background と他の拡張パラメーター | バックグラウンド非同期実行は非対応。公式 Responses Reference に未掲載の OpenAI パラメーターは無視 |
| フィールド | 差分の説明 |
|---|
thinking.type | enabled/disabled に対応し、思考は既定で有効。Claude の adaptive は使用しない |
output_config.effort | low/medium/xhigh を使用、既定値 xhigh。high/max は xhigh に対応。Chat の互換値をすべて転用しない |
thinking.budget_tokens | 公式に廃止予定。新規接続は output_config.effort を使用。旧予算を残すなら max_tokens はその予算より大きくする |
max_tokens | 必須。Qwen3.8 では思考と最終回答の合計 Token 数 |
temperature、messages[].role | 温度範囲は [0,2)。user/assistant 以外に system ロールも使用可能 |
tool_result.content | ツール結果は文字列で返す。オブジェクトや配列は事前に直列化し、Claude のブロック配列を使わない |
output_config.format | 厳密 JSON Schema 対応。type: "json_schema" を使い、Schema は schema 内。additionalProperties は false が必要 |
tools 内の web_search | 検索名は web_search、型は web_search_20250305 など日付付き。HTTP／SDK では system に識別子 x-anthropic-billing-header: cc_entrypoint=cli; も必要 |
| フィールド | 差分の説明 |
|---|
| 暗黙キャッシュ | 自動有効。同一プレフィックスは最低 1024 Token が必要だが、毎回のヒットは保証しない |
| Chat／Messages の明示的キャッシュ | ブロックに cache_control: { type: "ephemeral" } を設定。最低 1024 Token、有効期間 5 分間、ヒットで更新。最大 4 マーカー |
| 明示的キャッシュの位置 | system はブロック配列が必要。ツール定義もプレフィックスに含むが、ツール定義だけのマーカーは無視。他の TTL やブレークポイントは転用しない |
| Responses Session キャッシュ | Header x-dashscope-session-cache: enable で有効。既定値は disable。Session 無効化でも自動暗黙キャッシュは無効にならない |
| キャッシュ使用量 | Chat は usage.prompt_tokens_details.cached_tokens、Responses は usage.input_tokens_details.cached_tokens、Messages は usage.cache_read_input_tokens と usage.cache_creation_input_tokens を確認 |
MODEL_ID をプラットフォームの完全なモデル ID に置換し、自分の API Key を使用してください。
curl 'https://api.agtcloud.cn/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API のタイムアウトの調査方法を三点で説明してください"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096
}'