GLM API 密钥：故障排除指南

为什么您的密钥返回 'Unauthorized'

“Unauthorized”（未授权）错误通常源于配置的 API 密钥与基础 URL 端点不匹配。当将新的 LLM 集成到 Zed 或 Trae 等编辑器时，必须确保基础 URL 直接指向提供者的聊天完成端点，而非通用代理。如果您使用 OpenAI 兼容客户端，我们服务的基础 URL 为 HTTPS://api.apiglm.com/v1。传递错误的 URL 或过期的密钥会立即触发此 401 响应。

另一个常见原因是以错误的 header 格式发送密钥。某些客户端期望 'Authorization: Bearer '，而其他客户端可能会误解输入字段。请确保您的密钥与仪表板上显示的一致，在通过 Google 或电子邮件登录后复制。没有电话号码验证步骤，因此如果密钥有效，它应在任何标准 OpenAI SDK 实现中都能正常工作。

• 检查基础 URL 以 /v1 结尾。
• 确保 URL 字符串中无尾随斜杠。
• 验证密钥未被撤销或替换。

处理“思考块”问题

使用推理型模型的用户常遇到空的“思考”块，即模型输出了标签但未输出文本。这未必是代码错误，而是底层无限制模型架构的行为。模型可能会输出包含空格或空字符的推理块，解析器可能将其解释为空响应。

要处理此问题，请配置您的客户端以忽略空的推理标签或在处理前去除空白。如果您使用的是自定义推理转换器，请确保它能正确处理这些边缘情况。该模型针对直接答案进行了调整，因此过多的思考块有时表明需要调整 'temperature' 或 'top_p' 参数以鼓励更直接的响应。

调试此问题需要记录原始响应字节。如果思考块存在但为空，则可以安全地跳过它并继续生成实际内容。这确保您的应用不会因等待不存在的文本而挂起。

配置编辑器中的基础 URL

将无审查 LLM 集成到 Zed 或 Claude Code 等本地编辑器需要覆盖默认的环境变量。大多数编辑器默认使用 OpenAI 的 base URL。您必须在配置文件中显式设置 base URL 为 HTTPS://api.apiglm.com/v1。

对于 .env.development 或 config.js 文件，请确保 API 密钥变量正确映射。例如，将基础 URL 变量设置为指向我们的端点。这能确保所有请求（包括函数调用和流式传输）都通过我们的基础设施路由。如果编辑器不支持自定义基础 URL，您可能需要使用代理或包装脚本，将标准 OpenAI 协议转换到我们的端点。

通过发送简单的“ping”请求来验证集成。如果您收到有效的 JSON 响应，则您的配置正确。在尝试复杂的多轮对话之前，此步骤至关重要。

速率限制与并发错误

我们的基础设施实施严格的速率限制，以确保高用量期间的稳定性。每个 API 密钥限制为每分钟 300 次请求，最多可处理 8 个并发请求。如果超出这些限制，你将收到 429 Too Many Requests 错误。

为避免这些错误，请在客户端代码中实现指数退避。如果可用，请监控响应中的 'Retry-After' 标头。此外，确保您的应用程序在高峰时段不会出现流量激增。如果您运行多个实例，请在不同的密钥之间分配负载，或在应用层面管理并发。

请求体大小也限制为 8 MB。大型提示或大量工具调用可能会超过此限制。拆分输入或减少并发请求数量以保持在这些限制内。这些限制是透明的，旨在防止资源耗尽。

Token 计数与上下文窗口

理解 Token 用量对于成本管理至关重要。我们的模型支持 100,000 Token 的上下文窗口，包括提示和补全。每次请求的最大输出为 16,000 Token，如果您未指定 'max_tokens'，则默认为 2,048 Token。

定价基于实际令牌用量：输入令牌每百万 0.15 美元，输出令牌每百万 0.50 美元。错误和拒绝不收费，因此您只需为成功的生成内容付费。这种预付费模式意味着您的信用额度永不过期，您可以随时通过加密货币充值。

通过解析响应元数据在您的应用程序中追踪令牌使用情况。流式响应的最后一个数据块包含总令牌计数。这使您能够实时监控成本并调整提示词以保持在预算内。高效的令牌使用是最大化预存余额价值的关键。

流式响应解析

流式响应通过服务器发送事件（SSE）交付。每个数据块包含响应的一部分，但令牌使用数据仅包含在最后一个数据块中。这意味着您无法在流完成之前计算总令牌使用量。

通过监听 'data' 事件来解析流。累积文本数据块以形成完整响应。当收到最后一个数据块时，提取 'usage' 字段以更新本地令牌计数。这种方法确保了准确的计费，并帮助您监控资源消耗。

优雅处理网络中断。如果流断开，您可能需要重试请求。确保您的客户端能够处理部分响应并正确重新组装它们。流式传输非常适合实时应用程序，但需要健壮的错误处理。

函数调用参数错误

函数调用需要精确的参数配置。确保您的 'tools' 数组正确定义了函数模式，包括参数和描述。'tool_choice' 参数可以设置为 'auto'、'required' 或特定的函数名称。

常见错误包括工具模式中缺少必填字段或数据类型不正确。请验证您的客户端是否发送了 'response_format' 为 'json_object'，如果您期望结构化输出。这确保模型返回您的应用程序可以解析的有效 JSON。

首先使用简单工具测试函数调用。逐步增加复杂度以识别任何模式不匹配。如果模型未能调用工具，请检查响应中的 'tool_calls' 字段以查找错误。正确的配置对于可靠的函数调用至关重要。

加密货币充值延迟修复

通过加密货币充值余额，具体为 USDT (TRC20) 或 USDC (Base)。交易可能需要几分钟才能在区块链上确认。如果余额未立即到账，请等待网络确认。

针对 $50 或以上的充值自动应用奖励余额：$50 获得 +5%，$100 获得 +10%，$200 获得 +15%。请确保发送准确金额以获得正确的奖励。低于 $20 或高于 $500 的交易可能不会获得奖励或可能被拒绝。

如果您遇到重复扣款，请通过支持页面联系支持团队。余额不退款，但可以进行调整。保留交易 ID 记录以便更快解决。这种预付费模式确保您不会因过期而损失余额。

模型 ID 配置错误

使用错误的模型 ID 是常见的错误来源。对于我们的无审查模型，ID 仅为 'uncensored'。发送带有 'gpt-4' 或 'claude-3' 的请求将导致“模型未找到”错误。

确保您的客户端在每个请求中明确将 'model' 字段设置为 'uncensored'。当使用可能默认使用其他模型的 OpenAI 兼容 SDK 时，这一点至关重要。验证配置文件和测试请求中的模型 ID。

我们的服务不提供模型路由或多模型选择。它是一个专为无审查文本生成设计的单模型端点。这种简化降低了复杂性并确保性能一致。在部署到生产环境前，请务必再次检查模型 ID。