帮助中心
常见问题
鉴权、模型、分组、额度与客户端配置
401：API Key 无效怎么办？＋
确认请求头格式为 Authorization: Bearer YOUR_API_KEY，并检查密钥是否已停用或粘贴了空格。
为什么返回 model_not_found？＋
先调用 GET /v1/models 获取当前密钥可用模型，并使用返回的完整模型 ID。
如何查看当前 API Key 可调用的模型？＋
调用 GET /v1/models，data 中返回的完整模型 ID 均可直接使用。glm-5.2 请使用智谱分组的 API Key。
图像请求为什么很久没有返回？＋
图像生成通常明显慢于文本接口，请把客户端读取超时提高到 3–5 分钟。客户端超时后结果状态未知，当前没有任务查询端点；不要自动重试，以免重复生成与计费。
遇到 429 应该如何重试？＋
读取 Retry-After，使用指数退避并增加随机抖动；不要持续固定频率轮询。
OpenAI SDK 能直接使用吗？＋
可以。保留官方 SDK，只需替换 base_url、API Key 和模型名称。