GLM-5.3

項目	填寫值
Base URL	`https://api.hop-base.com/v1`
模型名	`glm-5.3`
對話	僅 `POST /v1/chat/completions`——不支援 `/v1/responses` 與 `/v1/messages`，呼叫返回 400

密鑰須包含GLM 官方直連分組，不含該分組的 Key 會收到 404。

分組與計費

GLM-5.3 是智譜最新旗艦模型：1M 上下文，支援思考長度控制，官方直連接入。

glm-5.3 在GLM 官方直連分組在售，1M 上下文。在控制台「API 金鑰」新建或編輯密鑰時，把這個分組加進密鑰，實際結算價以登入後模型廣場為準。
兩個分組都不含的 Key 調用 glm-5.3 會收到明確的 404 提示——在控制台給現有 Key 加上其中一個分組，或新建一把包含它的 Key。
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-你的密鑰`
模型	`glm-5.3`
API 格式（僅 CC Switch 等支援路由的用戶端需要）	`OpenAI Chat Completions（需開啟路由）`

上面的「API 格式」這一欄，只存在於 CC Switch 這類能在協議之間做本機路由的用戶端裡，不是請求內容裡的參數。在 Claude Code、CC Switch 等支持路由的客戶端裡，GLM-5.3 不走 Anthropic 協議；請在高級選項把 API 格式設為 OpenAI Chat Completions（需開啟路由）。如果你用的是原生 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- 密鑰
請求地址：https://api.hop-base.com/v1

設定 API 格式和模型映射

展開「高級選項」，按下面設定後儲存：

API 格式：OpenAI Chat Completions（需開啟路由）
認證字段：保持預設的 ANTHROPIC_AUTH_TOKEN
預設兜底模型：glm-5.3

如果希望 Sonnet、Opus、Haiku 三個檔位都固定使用 GLM-5.3，也把這三個模型映射都填成 glm-5.3。儲存後，供應商卡片會顯示「需要路由」。

開啟本地路由

進入 設定 → 路由 → 本地路由，先打開「路由總開關」，再在「路由啟用」中打開 Claude Code。首次開啟會彈出說明，確認後保持 CC Switch 在背景執行。

Enable 並驗證

回到 Claude Code 供應商列表，在 HopBase GLM 卡片上點 Enable。首次開啟路由接管後，關閉目前終端機並重新打開，執行 claude，傳送一個簡短問題。

再回到 設定 → 路由：如果「目前 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、通義千問，或三種協議都支援的美國區 glm-5.3-us，見美國區。

OpenAI SDK / Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key="sk-你的密鑰",
)

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{
        "role": "user",
        "content": "解釋一下 GLM-5.3 的適用場景",
    }],
)
print(resp.choices[0].message.content)

curl

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密鑰" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "你好，介紹一下你自己"}]
  }'

下一步

GLM-5.3 Flash——多模態、更低單價
CC Switch——本地路由的安裝與排錯
錯誤碼與重試
並行、逾時與計費

本頁目錄