API | GLM 5.3 API — 推論 max、1M 文脈

zai/glm-5.3/chat

GLM 5.3 は Z.ai のフルサイズの長文コンテキスト対応チャットモデルで、OpenAI 互換の呼び出しで使えます。最大 1,048,576 トークンを読み、最大 131,072 を返し、推論強度は max まで、ツールスキーマ 128 個、JSON 出力に対応します。

入力 $1.05出力 $3.30100 万トークンあたりキャッシュ入力 $0.195Z.ai 公式価格~~$1.40$4.40~~

モデルを実行 API を見る

リクエストを送信

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携

POSThttps://api.spicyapi.ai/v1/chat/completions

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "zai/glm-5.3/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

このモデルの入力スキーマから生成した例です。API はどのリクエストも、同じスキーマで検証します。

同じ論理リクエストには同じ Idempotency-Key を使い続けてください。通信が切れた場合は新しいキーで自動再送せず、受理済みリクエストを追跡できるよう request_id を保存します。冪等性は、過去のチャットストリームを再生するものではありません。

入力パラメーター

モデルのパラメーターは、JSON リクエスト本文の model と同じ階層に指定します。このエンドポイントでは input でラップしません。

messagesarray<object>必須

順序付きのターンを最大 256 件、内容はテキストのみです。資料は 1 つの user メッセージに、問いと出力形式は system メッセージに置いてください。

デフォルト値: 指定なし
制約: minItems:1
maxItems:256

messages[].rolestringオブジェクト内で必須

Role of the message author.

デフォルト値: 指定なし
使用可能な値: "system""developer""user""assistant""tool"

messages[].namestring任意

Optional name identifying the speaker within its role.

デフォルト値: 指定なし

messages[].contentstring | array | null任意

Message content, either plain text or a list of content parts.

デフォルト値: 指定なし

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>任意

Tool calls the assistant requested in this message.

デフォルト値: 指定なし

messages[].tool_call_idstring任意

Identifier of the tool call this message answers. Required on tool messages.

デフォルト値: 指定なし

messages[].reasoning_contentstring任意

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

デフォルト値: 指定なし

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobject任意

JSON オブジェクトを要求し、キーはすべて system メッセージで名指ししてください。

デフォルト値: 指定なし

tool_choicestring | object任意

auto / none / required、または呼ぶ関数を名指しするオブジェクト。

デフォルト値: 指定なし

parallel_tool_callsboolean任意

true か false で、既定値は true です。true ではモデルが 1 ターンで複数のツール呼び出しを要求できます。false にすると 1 ターンあたりの呼び出しは最大 1 件になり、前の結果に次の呼び出しが依存するループに向きます。料金には影響しません。

デフォルト値: true

toolsarray<object>任意

1 リクエストにつき最大 128 個の関数定義。

デフォルト値: 指定なし
制約: maxItems:128

top_pnumber任意

0.01〜1、既定 0.95。同じ比較の中で、これと temperature を同時に動かさないでください。

デフォルト値: 0.95
制約: minimum:0.01
maximum:1

temperaturenumber任意

0〜1、既定 1。返答をコードが解析する場合は 0 に保ってください。

デフォルト値: 1
制約: minimum:0
maximum:1

seedinteger任意

任意の整数です。ほかが同じリクエストで同じ seed を使うと応答がほぼ再現されるため、1 か所ずつ変えて公平に比べられます。ただし完全に同じ出力を保証するものではありません。既定値はなく、毎回新しく抽選されます。料金には影響しません。

デフォルト値: 指定なし

max_tokensinteger任意

返答を 131,072 で抑えます。既定は 32,768 です。結論だけでなく導き方まで求めるときは上げてください。

デフォルト値: 32768
制約: minimum:1
maximum:131072

stopstring | array任意

停止シーケンスは 1 件だけで、文字列か要素 1 つの配列で指定します（Z.ai が読むのは 1 件のみです）。モデルがそれを書いた時点で応答が終わり、一致した文字列は返されません。推論の途中で一致して、回答が出る前にターンが終わることもあるため、推論に現れにくい文字列を選んでください。既定値はありません。単価は変わらず、途中で止まった応答は生成されたトークン分だけ課金されます。

デフォルト値: 指定なし
制約: minLength:1
minItems:1
maxItems:1

reasoning_effortstring任意

low / high / max。Z.ai 自身の API と同じく既定は max で、複数の事実を同時に正しく組み合わせる必要がある答えのための段です。大量処理では low か high に下げてください。

デフォルト値: "max"
使用可能な値: "low""high""max"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 1,
      "minItems": 1,
      "minLength": 1,
      "description": "A sequence that ends the reply as soon as the model writes it; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 0.95,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 32768,
      "maximum": 131072,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "high",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "max",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-input-token-limit": 1048576,
  "additionalProperties": false
}

結果を取得

stream が false の場合、完成したチャット応答が直接返ります。choices[].message を読み取ってください。タスクのポーリングは不要です。Server-Sent Events 対応のクライアントでは stream を true にできます。

完了レスポンスの例

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "zai/glm-5.3/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

レスポンス例は構造を示すためのものです。usage はトークン数を示し、実際のトークン数と料金はリクエスト内容によって変わります。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

SDKs

TypeScript · Python · Go · PHP · Java

CLI

ターミナルコマンドと自動化スクリプト。

MCP

Claude Code · Cursor · Codex

Agent Skill

AI アシスタントで再利用できる手順。

n8n

セルフホスト版のコミュニティノードと、n8n Cloud にインポートできる HTTP Request テンプレート。

ComfyUI

ノードで組み立てる画像・動画・音声ワークフロー。

その他の連携

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

すぐ使えるワークフローを見る

これはチャットモデルなので、OpenAI のチャット API が通る場所ならどこでも動きます。クライアントはそのまま、ベース URL を差し替えて、このモデル ID を指定してください。

OpenAI 互換クライアントの向き先を変えるだけ

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/zai/glm-5.3/chat

OpenAI のチャット API に対応するツールは同じ方法で使えます。SDK、Vercel AI SDK、LangChain、aider、Cline などに対応します。MCP サーバーと spicyapi CLI は非同期のメディアタスクに対応します。ツールごとの設定は開発者ハブをご覧ください。

SillyTavern やロールプレイアプリで使う

SillyTavern、RisuAI、Agnai など OpenAI 互換の設定があるアプリに、下のベース URL と API キーを貼り付け、モデルに zai/glm-5.3/chat を選んでください。ブラウザーからの呼び出しにも対応しており、このモデルが受け付けないスライダーはエラーにならず無視されます。

Base URL: https://api.spicyapi.ai/v1
Model: zai/glm-5.3/chat

SillyTavern ガイド RisuAI・Agnai ほか SillyTavern 拡張機能

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、SpicyAPI Chat ノードで zai/glm-5.3/chat を選ぶと、ComfyUI のグラフの中でこのモデルを使えます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

ワークフロー例セットアップガイド GitHub のソース

埋め込みパネルはこのページと同じスキーマを参照するため、API 仕様とのずれを防げます。ドキュメント内の検索対象にする場合は、/api/embed/models/ の JSON を取得して描画してください。

<iframe src="https://spicyapi.ai/embed/ja/models/glm-5-3/api?model=zai%2Fglm-5.3%2Fchat" width="100%" height="560" loading="lazy" title="リクエスト例" style="border:1px solid rgba(0,0,0,.12)"></iframe>

パネルを開く

プレイグラウンド

リクエストを送信

API 認証

入力パラメーター

結果を取得

SDK・連携

SillyTavern やロールプレイアプリで使う

ComfyUI で使う