API 控制台 — LLM Gateway

配额概览

你的 Key

🔑 Key 与账户绑定：任何设备登录账户都能在这里看到同一个 Key；点「重置 Key」才会换新，旧 Key 立即失效。

配置信息

模型名称 GLM-5.3

💡 Cursor / ChatBox 等工具填入 Base URL + Key + 模型名称（GLM-5.3）即可使用

API Base URL（三种协议）

按你的客户端类型复制对应 Base URL 即可；下方「客户端配置」有逐客户端图文步骤。每个 Base URL 后的 ? 悬停可见填写说明。

OpenAI Chat Completions Cursor · ChatBox · Trae · CC Switch · 通用 OpenAI 客户端

Base URL ?填客户端的 Base URL 处，客户端会自动在后面拼接 /chat/completions，因此这里带 /v1。

https://ai.shimiaocheng.top/v1

Anthropic Messages Claude Code CLI（原生接入，无需中转代理）

Base URL ?Claude Code 的 Anthropic SDK 会自动拼接 /v1/messages，所以 Base URL 不要带 /v1，直接填域名根；误带会变成 /v1/v1/messages 导致 404。

https://ai.shimiaocheng.top

OpenAI Responses Codex CLI（原生接入，2026 仅走此协议）

Base URL ?Codex 的 Responses SDK 会自动在 Base URL 后拼接 /responses，因此这里带 /v1。

https://ai.shimiaocheng.top/v1

API 使用方式

API 端点（同步调用）

curl https://ai.shimiaocheng.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"GLM-5.3","messages":[{"role":"user","content":"你好"}]}'

API 端点（SSE 流式调用）

curl https://ai.shimiaocheng.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"GLM-5.3","messages":[{"role":"user","content":"你好"}],"stream":true}'

Python 示例

import requests

response = requests.post(
    "https://ai.shimiaocheng.top/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"model":"GLM-5.3", "messages":[{"role":"user","content":"你好"}]}
)
print(response.json())

模型字段填 GLM-5.3 即可（网关当前默认模型）。

客户端配置

复制你的 Key

sk-...

复制你的客户端对应的 Base URL

Anthropic（Claude Code）?不带 /v1，SDK 自动拼 /v1/messages，误带会变成 /v1/v1/messages 导致 404。

https://ai.shimiaocheng.top

OpenAI 兼容（Cursor / ChatBox 等）?带 /v1，客户端自动在后面拼 /chat/completions。

https://ai.shimiaocheng.top/v1

Responses（Codex）?带 /v1，SDK 自动在后面拼 /responses。

https://ai.shimiaocheng.top/v1

复制对应客户端的 Base URL 填到客户端即可；完整图文步骤见下方「客户端配置」。

在下方选择你的客户端，按步骤填入即可使用

填 Base URL + 你的 Key + 模型 GLM-5.3。（Codex 走 /v1/responses，见下方专条）

GLM-5.3-FLASH（新 · 多模态 · 更省额度）

✅ 已上线：GLM-5.3-FLASH 是智谱新一代原生多模态模型（支持图片/视频/文件输入），上下文 1M。计量计费与 GLM-5.3 完全一致（按时段倍率、按 token 统一计），智谱侧更省配额——同样额度用得更久。

怎么用：任一 OpenAI 兼容客户端里，把模型名从 GLM-5.3 改成 GLM-5.3-FLASH 即可，Base URL 和 Key 都不变。
快速验证（curl）：

curl https://ai.shimiaocheng.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的子Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"GLM-5.3-FLASH","messages":[{"role":"user","content":"你好"}]}'

✅ 适用范围：Claude Code 与 Codex 也可用 flash——在这两类客户端的配置里把模型名填成 GLM-5.3-FLASH 即可（不填或填 claude-* / gpt-* 等其他名字仍走 GLM-5.3）。Cursor / ChatBox / Trae / OpenCode 等所有手动填模型的客户端同样支持。

💡 视觉 Coding 玩法：flash 原生多模态，可以把页面截图发给它让它复刻界面，或丢文档进去问问题——写代码 + 看图两不误。

Claude Code

✅ 原生支持：本网关已原生兼容 Anthropic Messages API（/v1/messages），Claude Code 可直接接入，无需中转代理。

⚠️ Base URL 严禁带 /v1：Claude Code 会自动拼接 /v1/messages，若填成 …/v1 实际请求会变成 …/v1/v1/messages 导致 404 报错。请严格填 https://ai.shimiaocheng.top（见下方配置）。

将以下 settings.json 配置复制即用（sk-你的子Key 换成页面顶部「你的 Key」里的值）：
模型名统一填 GLM-5.3（你实际调用的就是智谱 GLM-5.3）。个别老版本 Claude Code 若模型列表为空，可把这三个变量分别填 claude-sonnet-4-20250514 / claude-opus-4-20250514 / claude-haiku-4-20250514。

{
  "ANTHROPIC_BASE_URL": "https://ai.shimiaocheng.top",
  "ANTHROPIC_API_KEY": "sk-你的子Key",
  "ANTHROPIC_CUSTOM_HEADERS": "x-api-key: sk-你的子Key",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5.3",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5.3",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-5.3"
}

配置后完全退出并重启 Claude Code。模型列表里会出现 GLM-5.3，直接用 /model 选中它即可对话。无论你填的是 GLM-5.3 还是兼容写法的 claude-* 名，网关都会统一用智谱 GLM-5.3 为你服务。

CC Switch

CC Switch 是 Claude Code 的图形化管理器（GUI）。请用「OpenAI Chat Completions」格式接入（链路短、配置少、最稳），不要用 Anthropic Messages 格式——后者需额外填自定义 Header 且对客户端版本要求高，容易卡：
1. 新建供应商时，API 格式选择 OpenAI Chat Completions（需开启路由）。
2. Base URL（请求地址）填 https://ai.shimiaocheng.top/v1（⚠️ 必须带 /v1）。
3. 认证字段（API Key / 令牌）填页面顶部「你的 Key」框里的 sk-... 值（无需自定义 Header）。
4. 模型填 GLM-5.3，保存后切换到该供应商即可对话。
⚠️ CC Switch 走 OpenAI 格式时 Base URL 必须带 /v1（与 Claude Code CLI 相反，后者才不带 /v1）。带错会出现「路径 404 / 连接失败」。改完保存后建议先退出客户端再重开。

ZCode

ZCode 是 Z.ai（智谱）官方的 AI 编码开发工具，支持添加「自定义供应商」接入本网关：
1. 打开 ZCode，点击左下角 模型选择器 → 管理模型 → 模型设置。
2. 点击 添加自定义供应商，协议类型选择 Chat（OpenAI Chat Completions 格式）——⚠️ ZCode 默认是 Anthropic 协议，务必手动切到 Chat。
3. API 基础 URL 填 https://ai.shimiaocheng.top/v1（⚠️ 带 /v1）。
4. API Key 填页面顶部「你的 Key」框里的 sk-... 值。
5. 模型名称 填 GLM-5.3。
6. 打开该供应商的启用开关并保存。
7. 回到对话框，选中 GLM-5.3 发一句话测试连通性。
⚠️ ZCode 自定义供应商协议只有 Chat 和 Anthropic 两种且默认 Anthropic：本网关请选 Chat 并配带 /v1 的 Base URL。若误用 Anthropic 格式需额外填自定义 Header 且链路长容易卡。

Trae

Trae 支持 OpenAI 兼容的自定义模型Provider。
1. 打开 Settings（设置） → Model Provider（模型供应商）。
2. 选择 Custom / OpenAI Compatible 自定义 Provider。
3. Base URL 填 https://ai.shimiaocheng.top/v1。
4. API Key 填页面顶部「你的 Key」框里的 sk-... 值。
5. Model 填 GLM-5.3，保存后即可选用。 ⚠️ 关键开关：「完整 URL / Full URL」必须保持关闭（默认关闭，不要打开）。Trae 开启该开关后会把你填的地址当作完整接口地址直接请求（不再自动拼接 /chat/completions），导致所有对话报 404 / 连接失败且无法定位原因。保持关闭即可，Trae 会自动在 Base URL 后拼接正确路径。

Codex (OpenAI CLI)

✅ 原生支持：本网关已实现 OpenAI Responses API 翻译层（/v1/responses），OpenAI Codex CLI 可直接接入，无需中转代理。Codex（2026）只走 Responses API，普通「OpenAI 兼容」填法（仅填 /v1）对它无效。

1. 安装 Codex CLI（需 Node 22+）：
npm install -g @openai/codex
2. 编辑配置文件 ~/.codex/config.toml（不存在则新建），填入以下内容（sk-你的子Key 换成页面顶部「你的 Key」里的值）：

model = "GLM-5.3"
model_provider = "shimiaocheng"

[model_providers.shimiaocheng]
name = "我的网关"
base_url = "https://ai.shimiaocheng.top/v1"
env_key = "GW_API_KEY"
wire_api = "responses"
requires_openai_auth = false

3. 在终端把 Key 注入环境变量（sk-你的子Key 同上）：
export GW_API_KEY="sk-你的子Key"
4. 运行 codex 即可开始对话。Codex 会自动向 /v1/responses 发起请求，网关将其翻译为上游模型并返回。
说明：model_provider 的 id 不能用 openai / ollama 等保留字；model 填 GLM-5.3 即可，网关会统一映射为默认模型（当前即 GLM-5.3）对外服务，填其他名称也会被统一映射。

Cursor

Cursor 是 OpenAI 兼容客户端，可直接自定义 Base URL。
1. 打开 Settings（设置） → Models（模型）。
2. 勾选 Override OpenAI Base URL，填入 https://ai.shimiaocheng.top/v1。
3. API Key 填页面顶部「你的 Key」框里的 sk-... 值。
4. Model 填 GLM-5.3。
5. 点击 Verify 验证通过后即可对话。

ChatBox

ChatBox 是支持 OpenAI 兼容协议的通用聊天客户端（Windows / macOS / 手机端均可）。
1. 打开 ChatBox，点击左下角 设置（齿轮图标），选择「使用自己的 API Key 或本地模型」。
2. 模型提供方 选择 OpenAI API（或在「添加自定义提供方」里选 OpenAI 兼容）。
3. API 域名 填 https://ai.shimiaocheng.top/v1（⚠️ 末尾的 /v1 不能漏，漏了会连接失败）。
4. API 密钥 填页面顶部「你的 Key」框里的 sk-... 值。
5. 模型 填 GLM-5.3；若下拉列表没有该模型，手动添加模型名即可。
6. 点击 保存，新建对话发一句「你好」测试，能正常回复即配置成功。

OpenCode

OpenCode 是开源 AI 编码 agent，通过配置文件接入 OpenAI 兼容 Provider。
1. 编辑配置文件 ~/.config/opencode/opencode.json（不存在则新建）。
2. 在 providers 中新增一个 openai-compatible 类型的 Provider：
baseUrl 填 https://ai.shimiaocheng.top/v1；
apiKey 填页面顶部「你的 Key」框里的 sk-... 值；
在 models 里添加一项名称为 GLM-5.3。
3. 重启 OpenCode，选择该 Provider 与 GLM-5.3 模型即可。

调用记录明细

展示你最近的 API 调用（每页 20 条，最多翻 50 页）。模型列为请求使用的模型名称；时间为北京时间。

时间	模型	输入	输出	总Token	倍率	状态	耗时
点击「调用记录」标签加载…

常见问题

按高频顺序整理。如果本页没有覆盖你的问题，请携带「调用记录」页的状态码与时间联系我们。

调用记录的「状态」列有哪些值？分别是什么意思？

状态列即 HTTP 状态码，共 7 种。按出现频率从高到低：

✓ 200 成功：调用正常完成，Token 正常计量，无需任何处理。

✕ 429 请求被拒：最常见的一类，细分 5 种语义，见下一个问题。

✕ 400 请求无效：请求体 JSON 格式错误，或模型名不在白名单内。检查请求体语法；模型名填 GLM-5.3。

✕ 502 网关超时：上游服务响应超时，多见于超长上下文的请求。稍后重试或减小单次请求规模。

✕ 500 / 503 上游异常：上游服务商内部错误或临时维护/过载。属于偶发，稍后重试即可。

✕ 401 认证失败：Key 填写错误或已失效。核对客户端中填写的 Key 与本页「我的Key」是否一致。

429 具体是哪种额度问题？怎么区分和处理？

429 有 5 种细分场景，客户端收到的报错文案可以直接区分：

1. 本周 Token 已超限（最常见）：周额度已用尽。等概览页显示的周重置时间自动恢复，或用「兑换码」tab 绑定新码续费。

2. 并发数超限（concurrency_limit_exceeded）：同时在途的请求数超过账户并发上限。降低客户端并发（如关掉并行子任务）后自动恢复。ℹ️ 并发拒绝不扣 Token，只记一条审计行，不用担心额度损失。

3. 5 小时内 Token 已超限：5 小时滚动窗口额度用尽。窗口从你首次消耗时刻起每 5 小时滚动回补，到概览页显示的重置时间自动恢复；也可续费提高额度。

4. 上游限流（Upstream returned 429）：上游服务商临时限流，与你账户额度无关。稍等片刻自动恢复，无需处理。

5. Token 额度已用尽：总量用尽。用「兑换码」tab 续费——有效期内续费总额度累加，账户到期后续费按新码额度从头起算。

为什么我的 Token 消耗特别快？什么是倍率？

高峰期（周一至周五 14:00–18:00（UTC+8））所有调用按 3× 倍率计量，其余时间 1×。也就是说高峰期一次消耗 10,000 token 的请求，会实际扣减 30,000 的额度。「调用记录」的倍率列会标注每笔的倍率，>1× 的会橙色高亮。
💡 想省额度：把大批量任务挪到高峰时段之外跑，消耗直接降为 1/3。

额度什么时候重置？

三个维度各自独立重置，具体时间点见「配额概览」每个卡片右侧的重置时间：
· 5 小时窗口：每用户滚动窗口——从你首次消耗的时刻起每 5 小时滚动回补（与上游智谱的动态刷新机制一致），各用户的重置时刻因而不尽相同；
· 周额度：按周对齐重置；
· 总额度：不按周期重置——有效期内持续累计，账户到期时随账户一起清零，续费后按新码额度起算。
兑换码续费会把有效期从续费日重算、总/周额度累加（到期后按新码重起），Key 保持不变。

Key 失效了 / 提示 401 怎么办？

1. 核对客户端里填的 Key 与本页「我的Key」完全一致（注意前后空格）；
2. 账户到期后 Key 会被禁用——在「兑换码」tab 绑定新码即可恢复，Key 不变；
3. 若确认 Key 无误仍 401，带上状态码与时间联系我们。

客户端报 404 / 连接失败？

绝大多数是 Base URL 填法问题，不同客户端规则不同（详见「客户端配置」tab）：
· OpenAI 兼容客户端（Cursor / ChatBox / Trae / CC Switch / Codex 等）：https://ai.shimiaocheng.top/v1，必须带 /v1；
· Claude Code CLI（Anthropic 格式）：https://ai.shimiaocheng.top，严禁带 /v1；
· Trae 专属：Provider 设置里的「完整 URL / Full URL」开关必须保持关闭。开启后 Trae 不再自动拼接 /chat/completions，会直接请求你填的地址，所有对话报 404 / 无响应。

账户到期或被禁用有什么表现？

配额概览的「有效期」行会显示到期时间，临近 7 天内会橙色预警，过期后变红且所有请求被拒。绑定新兑换码即可续期，所有客户端配置不变。

重置 API Key？

🔐 设置账户和密码

账户设置