GLM-5.3

項目	値
Base URL	`https://api.hop-base.com/v1`
モデル名	`glm-5.3`
チャット	`POST /v1/chat/completions` のみ — `/v1/responses` と `/v1/messages` は非対応で 400 を返します

「GLM 公式ダイレクト」プランを含むキーを使ってください。含まないキーでは 404 が返ります。

プラン選択と課金

GLM-5.3 は Zhipu の最新フラッグシップモデルです。1M トークンのコンテキストウィンドウと思考の長さ制御に対応し、公式直結で提供されます。

glm-5.3 は「GLM 公式ダイレクト」プランで提供され、コンテキストウィンドウは 1M です。コンソールの「APIキー」でキーを作成・編集する際、このプランをキーに追加してください。実際の適用レートはログイン後のモデルカタログに表示されます。
どちらのプランも含まないキーで glm-5.3 を呼び出すと明確な 404 が返ります。コンソールでキーにいずれかのプランを追加するか、そのプランを含む新しいキーを作成してください。
GLM-5.2 は提供を終了しました。これまで glm-5.2 を呼び出していたプロジェクトは、モデル名を glm-5.3 に変更するだけで移行できます。

リクエストパラメータ

POST /v1/chat/completions の場合です。ゲートウェイが拒否するのは空の messages だけで、ほかの制限はモデル側のものです。エラー文言は本番記録から引用しています。

パラメータ	必須	型と制限	デフォルト	説明
`model`	必須	`glm-5.3`	—	完全一致
`messages`	必須	空でない配列、テキストのみ	—	欠落・空配列はゲートウェイが 400、画像付きは 400。コンテキストは 1M
`max_tokens`	任意	整数 1–131,072	サービス既定	範囲外は 400 `max_tokens参数非法：限制数值范围[1,131072]`。思考と回答で共有
`reasoning_effort`	任意	`low` / `high` / `max`	モデル既定	常に思考します。`none` など思考をオフにする値は 400
`temperature`、`top_p`	任意	そのまま転送、ゲートウェイの範囲制限なし	サービス既定	サンプリング設定。そのまま転送されます
`tools`、`tool_choice`	任意	OpenAI と同じ	`auto`	返す `tool` の結果は前のターンの呼び出し ID と一致が必要。不一致は 400 `No tool call found for function call output`
`stream`	任意	真偽値	`false`	`true` で SSE ストリーミングを返します
`stream_options.include_usage`	任意	真偽値	`false`	ストリーミングで `usage` チャンクを受け取るには `true` が必要

思考オフによる 400 の文言はプランごとに異なるため、メッセージ本文ではなくステータスコードと reasoning_effort の値で判定してください。

クライアント設定項目

項目	値
API アドレス / Base URL	`https://api.hop-base.com/v1`
API Key	`sk-your-key`
モデル	`glm-5.3`
API 形式(CC Switch など、ルーティングに対応したクライアントのみ)	`OpenAI Chat Completions (routing required)`

上記の「API 形式」欄は、プロトコル間でローカルルーティングができる CC Switch などのクライアントにのみ存在する項目であり、リクエストボディに含めるパラメータではありません。Claude Code、CC Switch などルーティングに対応したクライアントでは、GLM-5.3 は Anthropic プロトコルを使用しません。詳細設定で OpenAI Chat Completions (routing required) を選択してください。素の OpenAI SDK や curl を使う場合はこの設定項目自体に触れることはないため、そのまま下記の該当セクションに進んでください。

CC Switch で Claude Code から GLM-5.3 を利用する

CC Switch 3.17.0 以降を使用してください。GLM-5.3 は OpenAI Chat Completions を使用するため、CC Switch のローカルルーターが Claude Code で使われる Anthropic Messages プロトコルへの変換を行う必要があります。

HopBase GLM プロバイダーを追加する

CC Switch を開き、Claude Code タブを選択して右上の + をクリックし、カスタム設定を選びます。以下を入力してください。

プロバイダー名:HopBase GLM
API Key:お使いの sk- キー
リクエスト URL:https://api.hop-base.com/v1

API 形式とモデルマッピングを設定する

詳細オプションを展開し、以下のように設定して保存します。

API 形式:OpenAI Chat Completions (routing required)
認証フィールド:デフォルトの ANTHROPIC_AUTH_TOKEN のまま
デフォルトのフォールバックモデル:glm-5.3

Sonnet、Opus、Haiku の各ロールを強制的に GLM-5.3 に固定したい場合は、この 3 つのロールもすべて glm-5.3 にマッピングしてください。保存後、プロバイダーカードに Routing required と表示されます。

ローカルルーティングを有効にする

設定 → Routing → Local routing を開きます。ルーティングのメインスイッチを有効にしてから、アプリケーションルーティングの中の Claude Code を有効にします。初回起動時のメッセージを確認し、CC Switch はバックグラウンドで起動したままにしてください。

プロバイダーを有効化して確認する

Claude Code のプロバイダー一覧に戻り、HopBase GLM カードで Enable を選択します。ルーティングの引き継ぎを初めて有効化した後は、ターミナルを一度閉じて開き直し、claude を実行して短いプロンプトを送信してください。

設定 → Routing に戻ります。Current Provider に HopBase GLM が表示され、リクエスト数が増加していれば設定は成功です。ルーティングが有効になった後は、プロバイダーの切り替えはホットスワップで反映され、ターミナルの再起動は不要です。

Codex CLI

「GLM 公式ダイレクト」プランの glm-5.3 と glm-5.3-flash は OpenAI Chat Completions のみに対応しています。/v1/responses は 400 endpoint_not_supported を返します。Codex CLI は 0.122 以降 Responses のみに対応している(wire_api = "chat" は削除済み)ため、Codex CLI から GLM-5.3 には接続できません。Codex CLI では GPT、DeepSeek、Qwen、または 3 つのプロトコルすべてに対応する米国リージョンの glm-5.3-us をお使いください(米国リージョンを参照)。

OpenAI SDK / Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key="sk-your-key",
)

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{
        "role": "user",
        "content": "Explain where GLM-5.3 works best",
    }],
)
print(resp.choices[0].message.content)

curl

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "Hello, introduce yourself"}]
  }'

次のステップ

GLM-5.3 Flash:マルチモーダル対応で単価が低いモデル
CC Switch:ローカルルーターの導入とトラブルシューティング
エラーコードと再試行
同時実行数、タイムアウト、課金

このページの内容