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——本地路由的安装与排错
错误码与重试
并发、超时与计费

本页目录