LongCat API开放平台常见问题解答
常规问题
Q: LongCat API开放平台可以提供什么服务？
A: LongCat API开放平台专为LongCat系列模型提供AI模型代理服务。通过兼容 OpenAI 和 Anthropic 的 API 格式，您可以使用现有的 SDK 和工具访问LongCat系列模型。
Q: LongCat API开放平台支持哪些注册/登录方式？
A: 中国大陆支持手机号注册/登录，非中国大陆用户支持手机号或邮箱注册/登录。
Q: 通过手机号登录时收不到验证码怎么办？
A: 中国大陆用户收不到验证码可致电客服电话1010-7888答疑。非大陆用户可切换邮箱登录，仍然收不到验证码可e-mail联系longcat-team@meituan.com。
认证与 API Key
Q: 如何获取 API Key？
A: 注册并登录后，请前往 API Keys 页面，点击“创建 API Key”手动生成密钥。创建时可自定义名称（2–50 字符，支持中英文、数字及特定符号）。API Key 仅在创建时可见，请及时复制并妥善保存，丢失需重新创建。
Q: 我可以创建多少个 API Key？
A: 每个用户最多可同时保留 100 个 API Key，累计创建上限为 200 个。达到上限后将无法继续创建，如有特殊需求，请通过邮件 longcat-team@meituan.com 联系我们。
Q: API Key 应该放在哪里？
A: 请在 Authorization 请求头中包含您的 API Key：Authorization: Bearer YOUR_API_KEY。
Q: 不同模型需要单独的 API Key 吗？
A: 不需要，您只需一个 LongCat API开放平台的 API Key 即可访问我们的 LongCat系列模型服务。
Q: OpenAI 和 Anthropic 两个接口可以用同一个 API Key 吗？
A: 可以，同一个 LongCat API开放平台的API Key 可用于 /openai/ 和 /anthropic/ 两个接口。
Q: 我的 API Key 无法使用，应该检查什么？
A: 请确认：
- API Key 格式正确，带有 "Bearer " 前缀
- 使用了正确的 base URL
- 账号有足够的余额
请求格式与参数
Q: OpenAI 和 Anthropic 两个接口有什么区别？
A:
- OpenAI 接口（
/openai/native/chat/completions）遵循 OpenAI 格式，包含 system/user/assistant 角色 - Anthropic 接口（
/anthropic/v1/messages）遵循 Claude 格式，单独的 system 参数 - 可根据您习惯的格式选择
Q: 如何启用流式响应？
A: 在请求体中设置 "stream": true。响应将以 Server-Sent Events (SSE) 形式返回。
Q: 最大 Token 限制是多少？
A:
- LongCat-2.0: 最多输出 128k Tokens
错误处理
Q: 返回 401 Unauthorized 错误是什么原因？
A: 通常原因如下：
- 缺少或无效的 API Key
- Authorization 请求头格式错误
Q: 返回 429 Rate Limit 错误是什么原因？
A: 请求过于频繁。请实现指数退避和重试逻辑，或降低请求频率。
Q: 返回 400 Bad Request 错误是什么原因？
A: 请检查：
- JSON 格式是否正确
- 是否包含所有必需参数
- 参数值是否在有效范围内
- 消息格式是否符合接口要求
Q: "context_length_exceeded" 是什么意思？
A: 您的输入（消息 + max_tokens）超过了模型的最大上下文窗口。建议：
- 减少消息数量
- 精简消息内容
- 降低 max_tokens 参数
SDK 集成
Q: 可以用官方 OpenAI Python SDK 吗？
A: 可以，只需更改 base URL：
openai.api_base = "https://api.longcat.chat/openai/"Q: 可以用官方 Anthropic Python SDK 吗？
A: 可以，配置 base URL：
client = anthropic.Anthropic(base_url="https://api.longcat.chat/anthropic")Q: 需要修改我的代码吗？
A: 只需做最小改动——通常只需更新 base URL 和 API Key。请求/响应格式保持兼容。
性能
Q: 响应速度如何？
A: 响应速度取决于：
- 请求长度和复杂度
- 服务器负载和地理位置
- 是否使用流式响应
Q: 是否有速率限制？
A: 有，每个 API Key 都有速率限制。超限时会返回 429 状态码。
Q: 如何处理超时？
A: 请在客户端实现合理的超时处理：
- 设置合理的连接和读取超时时间
- 使用指数退避进行重试
- 对于长响应建议使用流式模式
故障排查
Q: 我的流式响应突然中断怎么办？
A: 请检查：
- 网络连接问题
- 客户端超时设置
- 服务器端处理限制
- 客户端是否正确解析 SSE
Q: 如何调试请求/响应问题？
A: 请按如下步骤操作
- 启用 HTTP 客户端详细日志
- 检查响应头获取更多错误信息
- 确认请求格式完全符合文档要求
- 先用简单请求测试，再逐步增加复杂度
常见集成模式
Q: 如何监控 API 使用？
A: 建议实现日志和监控：
- 记录请求/响应时间
- 跟踪 Token 使用量
- 监控错误率
- 针对额度限制设置告警
财务问题
Q: 调用失败的请求会扣 Token 资源包 Token 额度或 API 按量付费余额吗？
A: 不会。HTTP 401 / 403 / 429 / 500 等失败响应都不会扣减额度/余额。只有成功返回（HTTP 200）的请求才按实际 Token 用量计费。
Q: API 按量付费充值余额的有效期是？
A: 充入余额长期有效、不过期，会一直保留直到被消耗或退款。
Q: API 按量计费余额不足时会怎样？
A: 余额不足或余额小于等于 ¥0 时，新的 API 请求会被拒绝。充值后余额大于¥0即可恢复。
Q: 哪些金额可以退款？
A: Token资源包和 API 按量计费两种计费方式的退款规则分别如下：
- 对于 Token资源包，退款规则如下：
- 仅限购买后 Token 额度未使用的订单申请退款。
- 退款申请通过后，对应 Token 额度将立即冻结回收。
- 每笔订单仅可申请一次退款，申请后不可撤销。
- 对于 API 按量计费，退款规则如下：
- 对于未消耗、未开票、未处于开票中的线上充值余额可以申请退款。
- 已消耗金额不支持退款。
- 最小退款金额为¥0.01。
- 微信、支付宝超过 12 个月的订单不支持退款。
- 计费可能存在延迟，可退款金额为预估金额，实际退款金额以到账金额为准
- 一个账户同一时间只能有一笔处理中的退款申请。
Q: 退款会退到哪里？
A: 审核通过后，款项会在1-3个工作日按原支付路径退回。
Q: 是否支持开发票？
A: 支持部分用户在 LongCat 页面自助开具发票
- 当前仅支持中国大陆用户自助开具发票；非中国大陆用户暂不支持线上开票，如有开票需求，可通过邮箱
longcat-team@meituan.com联系我们。 - 当前支持的发票类型是个人抬头电子发票，暂不支持企业开票。
- 对于API 按量计费，可开票金额 = 已消费金额 − 已开票金额；对于Token资源包，可开票金额是购买Token资源包使用的金额
- 发票通常会在 1–3 个工作日内开具。开具成功后，发票会发送至你填写的邮箱，也可以在开票记录中查看和下载。
Q: API 按量付费充值金额可以马上开票吗？
A: 不可以。预充值但未消费的金额不计入可开票金额。只有实际消费后的金额可以开票。
Q: 发票多久能开好？
A: 通常 1–3 个工作日内开具。开具完成后会发送至你填写的邮箱，也可以在页面中的开票记录中下载。