GLM のパラメーターとプロトコルの違い
互換プロトコルにおける GLM のパラメーターの違いと使い方を確認します。
GLM は選択したプロトコルに沿ってリクエストを作成し、本ページの差分を適用してください。公式に明記されたパラメーター差分をまとめています。完全な構造は Chat Completions、Responses、Messages を参照してください。
対象モデル
| モデル | 適用範囲 |
|---|---|
| GLM-5.3-FlashX、GLM-5.3-Flash | Chat のパラメーター差分とマルチモーダル補足 |
| GLM-5.3 | Chat、Responses のパラメーター差分 |
GLM-5.3 シリーズのテキストパラメーター
Chat Completions
| フィールド | 差分の説明 |
|---|---|
thinking.type | 思考は常に有効。enabled のみ対応し、disabled は非対応 |
reasoning_effort | low/high/max に対応。既定値は max |
temperature | 範囲は 0~1、既定値は 1。小数点以下は最大二桁 |
top_p | 範囲は 0.01~1、既定値は 0.95。小数点以下は最大二桁。温度とどちらか一方を調整 |
do_sample | GLM 拡張。既定値は true。false にすると temperature と top_p を無視 |
max_tokens | 範囲は 1~131072。思考と最終回答を含む出力予算 |
tool_stream | GLM 拡張。関数引数をストリーミングするには、これと stream をともに true に設定 |
thinking.clear_thinking | false にすると思考を保持。過去の思考を元の順序で完全に再送 |
reasoning_content | 思考内容。ストリーミングでは delta.reasoning_content に返却。交互思考のツールターンでは、同じメッセージの tool_calls とともに変更せず再送 |
request_id | GLM 拡張。6~64 文字で UUID も可。省略時はサービスが生成 |
user_id | GLM 拡張。6~128 文字。機密情報を含まない安定した利用者 ID を使用 |
tool_choice | GLM-5.3 は auto のみ対応 |
response_format.type | GLM-5.3 は text または json_object に対応 |
Responses
この節は GLM-5.3 が対象です。
| フィールド | 差分の説明 |
|---|---|
model、input | いずれも必須 |
temperature | 範囲は 0~1、既定値は 1。小数点以下は最大二桁 |
top_p | 範囲は 0.01~1、既定値は 0.95。小数点以下は最大二桁 |
max_output_tokens | 思考と回答を含む。既定値は 65536、最大 131072 |
reasoning.effort | 既定値は max。low/medium は high、xhigh は max に対応付け |
store | 既定値は false。保存やサーバー側の会話継続には明示的に true を指定 |
previous_response_id | 保存済み応答を継続。ID の有効期間は七日間 |
tool_choice | none または auto に対応 |
tools[].type | function、namespace、custom、web_search に対応 |
text.format.type | text または json_object に対応 |
Flash/FlashX のマルチモーダル補足
Flash/FlashX は上記 Chat テキストパラメーターを共有します。GLM-5.3 はテキストのみを受け付け、この節のブロックは使用しません。
| 入力 | Chat コンテンツブロック | 主要フィールド |
|---|---|---|
| 画像 | type: "image_url" | image_url.url に画像 URL または Base64 Data URL を指定。複数画像は別々のブロックを使用 |
| 動画 | type: "video_url" | video_url.url |
| ファイル | type: "file" | file.file_id、file.file_url、file.file_data のいずれか一つ。単一ファイルは最大 50 MB。旧 file_url ブロックは互換用のみ |
呼び出し例
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 のタイムアウトの調査方法を三点で説明してください"}],
"thinking": {"type": "enabled"},
"reasoning_effort": "low",
"max_tokens": 4096
}'