LongCat API 官方兼容格式与鉴权配置

一句话结论

LongCat 平台统一生产端点为 https://api.longcat.chat，同时兼容 OpenAI 与 Anthropic API 格式；但该总览页不列出旧 Flash-Chat 的当前可用模型，模型 ID 必须另行核实。

适用场景

• 适合的任务：记录 LongCat API 的 base URL、Bearer 鉴权、OpenAI/Anthropic SDK 兼容、错误处理和限流重试。

• 不适合的任务：据总览页直接恢复已退役的 LongCat-Flash-Chat API，或把通用接口兼容理解成模型仍可购买。

• 适用的模型版本：当前模型列表未在本页公开；LongCat-Flash-Chat 的历史 ID 需以 Change Log 和实际模型列表核对。

• 适用的客户端、Agent 或 API：OpenAI Python SDK（/openai/）、Anthropic Python SDK（/anthropic/）或标准 HTTP 客户端。

• 推荐的推理档位和参数：未公开；模型、max tokens、工具、stream、超时和重试应按当前具体接口文档固定。

可直接使用的内容

下面是依据官方总览页整理的环境配置检查表，不是完整请求代码：

provider: longcat-api
base_url: https://api.longcat.chat
authentication:
  header: Authorization
  scheme: Bearer
  value: YOUR_API_KEY
compatibility:
  openai_path_prefix: /openai/
  anthropic_path_prefix: /anthropic/
model: verify-against-current-model-list
request_record:
  model_snapshot: required
  format: openai-or-anthropic
  stream: record
  max_tokens: record
  tools: record
retry_on:
  - 429
  - 500
  - 502
  - 503

测试/工作流步骤

1. 先用 API key 调用当前模型列表或控制台，确认模型 ID 和旧 Flash-Chat 是否仍可用。

2. 选择 OpenAI 或 Anthropic 格式之一，固定 base path、stream、max tokens、工具 schema 和超时。

3. 将 400/401/402/403/429/500/502/503 分别映射为参数、鉴权、额度、权限、限流和服务故障处理。

4. 记录模型快照与响应错误，不要在 401/403/402 上盲目重试；429 和 5xx 才按退避策略处理。

原始证据与数据

• 官方总览页给出生产 endpoint https://api.longcat.chat。

• 官方说明所有请求使用 Authorization: Bearer YOUR_API_KEY。

• 官方说明兼容 OpenAI Python SDK 的 /openai/ 端点和 Anthropic Python SDK 的 /anthropic/ 端点。

• 官方列出 200、400、401、402、403、429、500、502、503 及对应错误类型/状态。

适用边界

• 该页面是 API 总览，不是 Flash-Chat 的模型卡或当前价格表；模型 ID、上下文、工具字段和可用地区未知就必须写“未公开/无法核实”。

• 旧模型已在官方 Change Log 中进入退役时间线；这份配置不能绕过模型下线或权限限制。

• 错误码映射不等于业务重试策略；写操作 Agent 仍需幂等、权限和人工接管。

来源摘录或观察（仅做合规短引）

• 官方将 LongCat API 描述为同时兼容 OpenAI 与 Anthropic 两种格式。

• 官方总览页把额度不足、权限不足、限流和上游故障分成不同错误状态，适合直接纳入客户端监控。