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。
账号认证与权益
Q: 哪些用户需要完成账号认证？
A: 中国大陆用户在充值或购买Token 资源包前，需要先完成个人实名认证或企业认证。
Q: 个人实名认证和企业认证有什么区别？
A: 个人实名认证面向个人用户，而企业认证面向企业、事业单位、社会团体等组织用户。
| 个人实名认证 | 企业认证 | |
|---|---|---|
| 适用对象 | 中国大陆个人用户 | 企业、事业单位、社会团体等组织 |
| 所需材料 | 真实姓名 + 证件号码 | 企业信息 + 法人人脸核验 或 企业信息 + 对公账户小额打款核验 |
| 解锁能力 | 充值、购买Token资源包 | 充值、购买Token资源包、开具专票、企业专属权益 |
Q: 个人实名认证后可以更改为企业认证吗？
A: 个人实名认证后可以更改为企业认证，原有权益全部保留。
Q: 企业认证后可以更改为个人认证吗？
A: 企业认证完成后不可以变更为个人实名认证，敬请谅解。
Q: 如何完成个人实名认证？
A: 操作步骤：
- 登录 LongCat 平台，进入「账号信息及配置」页面。
- 在「实名认证」区域点击「个人认证」。
- 填写真实姓名和证件号码，提交后即时完成认证。
Q: 如何申请企业认证？
A: 认证前请准备以下材料（须与营业执照一致）：企业名称、统一社会信用代码、法人姓名及法人证件。操作步骤：
- 登录 LongCat 平台，「账号信息及配置」页面。
- 在「实名认证」区域点击「企业认证」。
- 填写企业信息（企业名称、统一社会信用代码、法人信息），系统会实时校验信息真实性。
- 选择核验方式（法人扫脸或对公打款），完成核验后即通过企业认证。
Q: 企业认证选法人扫脸还是对公打款？
A: 两种方式任选其一即可通过认证：
- 法人扫脸：法人本人完成人脸核验，实时生效。适合法人本人可配合操作的场景。
- 对公打款：企业对公账户向平台打款验证，需要 1–3 个工作日。适合企业有对公账户的场景。
Q: 对公打款认证有哪些注意事项？
A: 请注意以下几点：
- 打款金额为随机小额验证金（小于 ¥1），仅用于核验对公账户真实性。
- 打款账户必须与认证企业名称一致，使用个人账户或第三方账户打款无法通过核验。
- 提交后认证状态为「企业认证中」，平台核验通常需要 1–3 个工作日。
- 平台收款账户信息以认证页面展示为准。
Q: 完成企业认证后有专属权益吗？
A: 完成企业认证即可享受两类专属权益：
- 按 API 按量付费月累计消费额提供阶梯式计费折扣，月消费越高折扣越大，最高6折。
- 面向大额月消费的企业用户提供专属服务，如有需要，可通过邮箱
longcat-team@meituan.com联系我们。
Q: API 按量付费阶梯折扣的规则是什么？
| 月累计消费 | 折扣 |
|---|---|
| ≥ ¥500 | 9 折 |
| ≥ ¥2,000 | 8 折 |
| ≥ ¥8,000 | 7 折 |
| ≥ ¥40,000 | 6 折 |
计算规则：
- 每月 1 日零点重置累计消费，重新计算阶梯。
- 累计消费按 API 按量付费的实际消耗计算：充值后未使用的金额不计入，Token 资源包消费与活动赠送额度不计入。
- 自企业认证完成之日起开始累计，认证前的消费不计入。
Q: 企业认证会影响已获得的权益或老带新活动吗？
A: 已获得的奖励全部保留。但企业认证后不允许再参加新的老带新活动；已在拼团中用户需先截团，再进行企业认证。
Q: 企业认证失败怎么办？
A: 请检查以下常见原因，修正后重新提交：
- 企业名称是否与营业执照完全一致。
- 统一社会信用代码是否正确。
- 法人证件信息是否有效。
- 对公打款方式：打款账户是否与认证企业一致。
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即可恢复。
A: 余额不足或余额小于等于 $0 时，新的 API 请求会被拒绝。充值后余额大于$0即可恢复。
Q: 哪些金额可以退款？
A: Token资源包和 API 按量计费两种计费方式的退款规则分别如下：
- 对于 Token资源包，退款规则如下：
- 仅限购买后 Token 额度未使用的订单申请退款。
- 退款申请通过后，对应 Token 额度将立即冻结回收。
- 每笔订单仅可申请一次退款，申请后不可撤销。
- 对于 API 按量计费，退款规则如下：
- 对于未消耗、未开票、未处于开票中的线上充值余额可以申请退款。
- 已消耗金额不支持退款。
- 最小退款金额为¥0.01。
- 微信、支付宝超过 12 个月的订单不支持退款。
- 计费可能存在延迟，可退款金额为预估金额，实际退款金额以到账金额为准
- 一个账户同一时间只能有一笔处理中的退款申请。
- 对于 Token资源包，退款规则如下：
- 仅限购买后 Token 额度未使用的订单申请退款。
- 退款申请通过后，对应 Token 额度将立即冻结回收。
- 每笔订单仅可申请一次退款，申请后不可撤销。
- 对于 API 按量计费，退款规则如下：
- 对于未消耗、未开票、未处于开票中的线上充值余额可以申请退款。
- 已消耗金额不支持退款。
- 最小退款金额为$0.01。
- 计费可能存在延迟，可退款金额为预估金额，实际退款金额以到账金额为准
- 一个账户同一时间只能有一笔处理中的退款申请。
Q: 退款会退到哪里？
A: 审核通过后，款项会在1-3个工作日按原支付路径退回。
发票问题
Q: 是否支持开发票？
A: 支持开发票，当前中国大陆用户可自助开具
- 当前仅支持中国大陆用户自助开具发票；非中国大陆用户暂不支持线上开票，如有开票需求，可通过邮箱
longcat-team@meituan.com联系我们。 - 发票类型支持普通发票（普票）与增值税专用发票（专票），开具专票需先完成企业认证。
- 对于API 按量计费，可开票金额 = 已消费金额 − 已开票金额；对于Token资源包，可开票金额是购买Token资源包使用的金额。
- 发票通常会在 1–3 个工作日内开具。开具成功后，发票会发送至你填写的邮箱，也可以在开票记录中查看和下载。
Q: 专票的抬头可以修改吗？
A: 不可以。专票抬头名称与税号取自企业认证信息且不可修改，以保证开票主体与认证主体一致。如企业信息变更，可通过邮箱longcat-team@meituan.com联系我们处理。
Q: API 按量付费充值金额可以马上开票吗？
A: 不可以。预充值但未消费的金额不计入可开票金额。只有实际消费后的金额可以开票。
Q: 发票多久能开好？
A: 通常 1–3 个工作日内开具。开具完成后会发送至你填写的邮箱，也可以在页面中的开票记录中下载。