Repository navigation
v0.2.0 · 双通道:免费 LongCat-2.5 + 妙手 LongCat-2.0
新增:免费 LongCat-2.5 通道
除了妙手(LongCat-2.0),现在多了一条 longcat.chat 网页通道,返回 LongCat-2.5,免登录、免费。
模型怎么选
| 想用 | 客户端里填 | 走哪条通道 | 凭据 |
|---|---|---|---|
| 2.5(新) | LongCat-2.5、longcat-2.5、2.5、web |
longcat.chat 网页 | 免登录 |
| 2.0(原) | LongCat-2.0、longcat、catpaw |
妙手账号池 | 妙手登录态 |
GET /v1/models 现在会同时列出两个,带 provider 字段。
特性
- 真实 token 用量:网页通道上游返回
tokenInfo,usage不再是估算值 - 限流保护:请求串行 + 最小间隔(默认 1500ms)+ 命中 429 本地冷却 90s
- 自动回落:2.5 被限流时按配置回落妙手 2.0(
longcat_web.fallback_to_catpaw),
响应头X-Longcat-Channel: catpaw(fallback)标明实际通道,绝不静默骗你 - 可选 Cookie:填
LONGCAT_WEB_COOKIE(登录 longcat.chat 后复制)走cn模式,额度和稳定性都更好 /healthz新增channels字段,含longcat_web.cooldown_left_s
已知限制(务必看)
- 网页通道不吃
tools/ function calling —— 只能当文本补全用,不能当 agent 后端(Claude Code 那种工具执行要官方 API)。 - 游客配额很小:连续十来次就
429 操作太快啦,冷却可能十几分钟。想稳定请填 Cookie。 - 上游
promptTokens基线约 449,是服务端自己的 agent 系统提示词,不是你的输入。
升级
# 把 image tag 改成 0.2.0
docker compose pull && docker compose up -d镜像:ghcr.io/xitihangto/longcat2api:0.2.0
(国内:ghcr.nju.edu.cn / ghcr.1ms.run / ghcr.dockerproxy.net 前缀)
验证
curl -s http://127.0.0.1:8090/healthz | python3 -m json.tool # 看 channels
curl -s -H 'Authorization: Bearer <key>' -H 'Content-Type: application/json' \
http://127.0.0.1:8090/v1/chat/completions \
-d '{"model":"2.5","messages":[{"role":"user","content":"你好"}]}' -D - | grep -i x-longcat-channel