常见问题

认证问题

为什么收到 401 Unauthorized 错误？

401 错误表示身份验证失败，通常由以下原因引起：

Token 填写错误：检查是否完整复制，无多余空格或换行
Token 已禁用或删除：进入控制台「令牌」页面确认 Token 状态为「启用」
变量名错误：Claude Code 需用 ANTHROPIC_AUTH_KEY，而非 ANTHROPIC_API_KEY
Token 格式错误：Inkess Token 以 ik- 开头

Claude Code 配置后仍然报 401？

确认使用的是 ANTHROPIC_AUTH_KEY 而非 ANTHROPIC_API_KEY。Claude Code 会优先读取 ANTHROPIC_AUTH_KEY 用于第三方代理认证，若只设置 ANTHROPIC_API_KEY 会被当作官方 Key 使用。

连接问题

请求超时怎么办？

大型语言模型生成内容需要时间，长文本输出可能需要 60-120 秒。建议：

将客户端超时时间设为 120 秒以上
开启流式输出（stream=True），可以逐步接收响应，避免等待全量结果

连接被拒绝 / Connection refused？

检查 API 地址是否正确：

Anthropic 兼容：https://llm.starapp.net/api/llm
OpenAI 兼容：https://llm.starapp.net/api/llm/v1

注意 https://，不要写成 http://。

频率限制

遇到 429 Too Many Requests？

触发了请求频率限制。稍等几秒后重试。如果频繁触发，可能是短时间内请求量过大，需要在代码中添加重试逻辑：

import time

for i in range(3):
    try:
        response = client.messages.create(...)
        break
    except Exception as e:
        if "429" in str(e):
            time.sleep(2 ** i)  # 指数退避
        else:
            raise

模型问题

为什么提示"模型不存在"？

可能的原因：

模型 ID 拼写错误：从控制台模型列表页面复制正确 ID
模型未开放：部分模型可能需要特定权限或暂时不可用
协议不匹配：通过 OpenAI 兼容接口使用 Anthropic 专属模型时格式可能不同

流式输出内容乱码或不完整？

确认 stream=True（Python）或 stream: true（JS）已正确设置，并正确处理流式事件。参考配置指南中的流式示例代码。

余额问题

余额不足时会怎样？

当账户余额为 0 或以下时，API 请求会返回 402 错误。请及时充值以保证服务不中断。

充值请进入控制台「充值」页面，支持微信扫码支付。

如何查看用量明细？

进入控制台「用量」页面，可按令牌或模型查看详细的 Token 消耗记录。

其他问题

如何获取技术支持？

查阅本文档中心，搜索相关关键词
进入控制台右下角「客服」入口，通过企业微信联系人工支持