API 概述
LongCat API 开放平台专为 LongCat 系列模型提供 AI 模型代理服务,同时兼容 OpenAI 和 Anthropic API 格式。本文档遵循标准 API 格式约定。
所有接口均通过统一生产环境端点
https://api.longcat.chat 访问,使用 Bearer Token 鉴权。 基础 URL
https://api.longcat.chat认证
所有 API 请求都需要在 Authorization 头中使用 API 密钥进行认证:
http
Authorization: Bearer YOUR_API_KEY接口一览
聊天补全 →
OpenAI 兼容格式,
POST /openai/v1/chat/completions。 Anthropic 消息 →
Anthropic Claude 格式,
POST /anthropic/v1/messages。 模型列表 →
列出可用模型,
GET /v1/models。 模型详情 →
获取模型详情,
GET /v1/models/{model}。 错误响应
API 使用常规 HTTP 响应码指示成功或失败:
| 状态码 | 状态名称 | 说明 |
|---|---|---|
200 | OK | 请求成功 |
400 | Bad Request | 请求参数无效或 JSON 格式错误 |
401 | Unauthorized | API 密钥无效或缺失 |
402 | Payment Required | Token 额度不足 |
403 | Forbidden | API 密钥无权限访问请求资源 |
429 | Too Many Requests | 超出速率限制 |
500 | Internal Server Error | 服务器遇到意外情况 |
502 | Bad Gateway | 上游服务器响应无效 |
503 | Service Unavailable | 服务器暂时不可用 |
错误响应格式
所有错误返回如下结构的 JSON 对象:
json
{
"error": {
"message": "人类可读的错误描述",
"type": "error_type_identifier",
"code": "specific_error_code"
}
}错误类型与代码
| 错误类型 | 错误代码 | HTTP 状态 | 说明 |
|---|---|---|---|
authentication_error | invalid_api_key | 401 | 提供的 API 密钥无效 |
permission_error | insufficient_quota | 403 | API 密钥配额不足 |
invalid_request_error | invalid_parameter | 400 | 参数值无效 |
invalid_request_error | invalid_json | 400 | JSON 格式无效 |
rate_limit_error | rate_limit_exceeded | 429 | 短时间内请求过多 |
server_error | internal_error | 500 | 服务器内部错误 |
速率限制
速率限制按 API 密钥执行。超出限制时会收到 429 状态码。
SDK 兼容性
本 API 设计兼容:
- OpenAI Python SDK(用于
/openai/端点) - Anthropic Python SDK(用于
/anthropic/端点) - 任何支持相应 API 格式的 HTTP 客户端
需要帮助?请查阅 常见问题 获取常见问题和故障排查指南。