テキストモデル上級者向け更新日
POST/v1/chat/completions
GLM 5.3
リクエスト ID glm-5.3
プロトコル
POST /v1/chat/completions· Chat Completionsの例POST /v1/messages· Anthropic Messagesの例POST /v1/messages/count_tokens· Count Tokensの例POST /v1/responses· OpenAI Responsesの例POST /v1/responses/compact· Responses Compactの例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY- Anthropic Messages ·
x-api-key: YOUR_API_KEY
リクエストパラメータ
POST /v1/chat/completions
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に glm-5.3 を指定します。 |
messages | object[] | 必須 | 会話順に送信します。各メッセージに role と content を指定します。 |
messages[].content | string / object[] | 条件付き | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
max_completion_tokens | integer | 条件付き | 推論トークンを含む生成トークン数を制限します。この項目に対応する接続先で使います。 |
max_tokens | integer | 条件付き | 出力トークン上限の互換項目です。接続先の要件に応じて、この項目か max_completion_tokens の一方を指定します。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
response_format | object | 条件付き | 構造化出力には type: json_object を使います。JSON Schema に対応する接続先では type: json_schema と json_schema を指定できます。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | string / object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/messages
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に glm-5.3 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
max_tokens | integer | 必須 | 出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/messages/count_tokens
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に glm-5.3 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
tools | object[] | 条件付き | 入力トークンの計算に含めるツール定義。Messages リクエストと同じツールを送信します。 |
POST /v1/responses
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に glm-5.3 を指定します。 |
input | string / object[] | 必須 | 入力テキスト、または入力項目の順序付き配列。メッセージ項目には role と content を指定します。 |
instructions | string | 任意 | タスクと出力の要件を指定するモデル向けの指示です。 |
max_output_tokens | integer | 任意 | 出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
store | boolean | 条件付き | この項目に対応する場合、false は後から取得するための応答保存を無効にするよう要求します。 |
text.format | object | 条件付き | 構造化出力は text.format に指定します。例は type: json_schema です。その形式に対応する接続先で使います。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | string / object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/responses/compact
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に glm-5.3 を指定します。 |
input | string / object[] | 必須 | 圧縮対象のコンテキストです。テキストまたは元の順序の会話入力項目を送信します。対応形式は接続先によって異なります。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "glm-5.3",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Count Tokens
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "glm-5.3",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
Responses Compact
bash
curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"input": "Explain how a rainbow forms in one sentence."
}'
レスポンスの読み取り
- Chat Completions ·
choices[].message.contentからテキストを取得します。SSE ではchoices[].deltaから差分を読み取ります。 JSON · SSE - Anthropic Messages ·
content[]からタイプがtextのブロックを取得します。ストリーミングでは SSE のコンテンツブロックイベントを順に処理します。 JSON · SSE - Count Tokens ·
input_tokensから入力トークン数を取得します。 - OpenAI Responses · ストリーミングでは
response.output_text.deltaイベントのdeltaを連結し、完了・失敗イベントも処理します。 SSE
機能と制限
streaming· 対応tool_calling· 条件付き対応 — 互換プロトコルとリクエスト形式によって異なりますimage_input· 未公開video_input· 非対応
互換エイリアスと廃止済みリダイレクト
glm-5.1,glm-5.2→glm-5.3(エイリアス)
関連ガイド
Claude Code で GLM-5.3 を使うには
Claude Code で GLM-5.3 を使うための API Key・Base URL・モデル設定を解説。Windows、macOS、Linux の環境変数を確認し、認証、モデル選択、接続の問題を解決します。
Chat Completions
OpenAI Chat 形式で会話を送信します。リクエスト前に、モデルと選択したエンドポイントの両方が Chat に対応していることを確認してください。
Anthropic Messages
Anthropic Messages 形式で HTTP リクエストを送信します。Claude Code を設定する場合は関連記事を参照してください。