GLM 全モデルインターフェース - Messages 完全なパラメータ
- Anthropic Messages プロトコルで GLM シリーズのモデルを呼び出し(モデルは
modelパラメータで選択) - リクエスト / レスポンス構造は Anthropic API に準拠
- システムプロンプト:トップレベルの
systemで渡します - 思考モード:全シリーズでデフォルトで思考が有効。思考内容は
content[type=thinking]block で返されます。無効にできるのはglm-5.2にthinking.type=disabledを渡す場合のみです - ストリーミング出力:SSE イベントストリーム
- ツール呼び出し:Anthropic の
tool_use/tool_resultフローに対応 - 画像入力:実際に対応しているのは
glm-5.3-flashのみ。詳細はmessagesフィールドの説明をご覧ください
https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルサービスの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。thinking.type: "disabled" に対応しているのは glm-5.2 のみです。glm-5.3 と glm-5.3-flash は常に思考し、disabled を渡すとエラーになります。glm-5.2 から移行する際は、ハードコードした disabled を先に削除してからモデルを切り替えてください。承認
##すべての API は Bearer Token 認証が必要です##
API キーの取得:
API キー管理ページにアクセスして API キーを取得してください
リクエストヘッダーに追加:
備考:EvoLink は /v1/messages に対して一律で Bearer Token 認証を採用しています。
ボディ
呼び出すモデル:
glm-5.3, glm-5.3-flash, glm-5.2 "glm-5.3"
対話メッセージのリスト。user / assistant がターンごとに交互に並びます
説明:
- 最低 1 件のメッセージが必要です
- 最後のメッセージは通常
role=userです - マルチターンのコンテキストに対応しており、モデルは履歴を参照します
画像入力:対応しているのは glm-5.3-flash のみで、content 配列内の {"type":"image","source":{...}} ブロックで渡します。
glm-5.3 や glm-5.2 に画像コンテンツブロックを渡してもエラーにはなりませんが、モデルは画像を読み取れません。リクエストは通常どおり 200 を返し、モデルはテキスト部分だけを根拠に回答するため、一見自然でも画像とは無関係な応答が返り、しかも結果はリクエストごとに一致しません。
この種のサイレント障害は本番環境で原因を追いにくいため、画像理解が必要な場合は glm-5.3-flash を選んでください。
1生成される内容の長さの上限(トークン数)
説明:
- GLM シリーズは最大 131,072 tokens(128K)の出力に対応しています。
1024以上の設定を推奨します - thinking で生成されるトークンもこの上限に含まれます
- 上限に達すると内容は打ち切られ、レスポンスは
stop_reason=max_tokensになります
1 <= x <= 1310721024
システムプロンプト。AI の役割と振る舞いを設定するために使用します
説明:
- 文字列またはコンテンツブロック配列に対応します
- トップレベルの
systemフィールドで渡します(messages には入れないでください) - モデルは system の制約に従います
- 長すぎる system は切り詰められる可能性があります:長い文脈が必要な場合は
messagesに入れ、すべてをsystemに詰め込まないでください
"You are a helpful assistant."
サンプリング温度
説明:
- 値が高いほど出力が発散的になり、低いほど確定的になります
- 推奨範囲
[0, 1]
0 <= x <= 11
核サンプリングのしきい値
説明:
- 範囲
[0, 1] - temperature と top_p を同時に調整しないことを推奨します
0 <= x <= 10.9
確率が最も高い K 個の token のみからサンプリングします(Anthropic 固有のパラメータ)
説明:
- 値が小さいほど出力が確定的になり、大きいほど候補が多様になります
x >= 010
カスタム停止シーケンス:生成がいずれかの文字列にヒットすると停止します
説明:
- ヒットすると切り詰められ、ヒット箇所より前の内容は正常に返却されます
- 注意:停止シーケンスにヒットした場合、GLM シリーズの
stop_reasonはend_turnを返し(Anthropic 標準のstop_sequenceではなく)、レスポンスにもstop_sequenceフィールドは含まれません。クライアントがstop_reason=="stop_sequence"でヒットを判定している場合は、特別な処理が必要です
SSE でストリーミング返却するかどうか
true:Server-Sent Events でストリーミング返却します(標準的な Anthropic イベントシーケンス:message_start / content_block_start / content_block_delta / message_delta / message_stop)false:完全なレスポンスを生成してから一括で返します(デフォルト)
false
深い思考を制御します
説明:
- GLM シリーズはいずれも推論モデルで、このフィールドを指定しない場合はデフォルトで思考が有効です
- 有効な場合、レスポンスの
content配列にtype="thinking"の推論過程 block が現れます(output トークンとして課金され、signatureは空文字列になる場合があります) - 有効なのは
typeの二値スイッチのみ:budget_tokensやeffortなどの思考予算 / レベルのパラメータは効きません(無視されます)
無効にできるかどうかはモデルによって異なります:
glm-5.2:{"type":"disabled"}を渡すと思考を無効にでき、output トークンを大幅に削減できますglm-5.3/glm-5.3-flash:常に思考し、無効化できません。disabledを渡すとエラーになります
その結果として、glm-5.3 シリーズは本エンドポイントでは思考コストを下げられません。 無効にできず(disabled はエラー)、
小さくすることもできません(budget_tokens と effort はいずれも効かず、トップレベルの reasoning_effort は OpenAI プロトコルのフィールドで本エンドポイントでは無視されます)。
思考内容は output トークンとして課金されるため、本エンドポイントではこのコストは避けられません。
思考コストを抑えたい場合は Chat Completions API に切り替えてください ——
そちらの reasoning_effort には low / high / max の 3 段階が実際に効きます。glm-5.2 はこの制限を受けず、本エンドポイントでも思考を直接無効化できます。
glm-5.2 からの移行:既存コードで thinking.type=disabled をハードコードしている場合、glm-5.3 に切り替える前にこのフィールドを削除する必要があります。そうしないとリクエストが直接失敗します。
また、思考を無効にしてコストを抑えていた場合、本エンドポイントに同等の代替はありません。移行の際は Chat Completions API への切り替えも併せて検討してください。
ツール定義のリスト
説明:
- Anthropic の tool 定義仕様に従います
input_schemaは JSON Schema オブジェクトを使用します- モデルは標準的な
tool_useblock を返し、stop_reason=tool_useになります
ツール選択戦略
リクエストのメタデータ
レスポンス
メッセージオブジェクト
Anthropic スタイルのメッセージレスポンス
メッセージの一意の ID(形式:msg_<uuid>)
レスポンスオブジェクトの種類
message assistant 実際に使用されたモデル
"glm-5.3"
レスポンスのコンテンツブロックのリスト
含まれる可能性のある block type:
thinking:推論過程(思考が有効な場合、デフォルトで有効)text:最終的な回答テキストtool_use:モデルが発起したツール呼び出し
停止理由
end_turn:自然終了(stop_sequences にヒットした場合もこの値を返します)max_tokens:max_tokens の上限に到達tool_use:モデルがツール呼び出しをトリガー
end_turn, max_tokens, tool_use Token 使用統計(Anthropic 仕様)