API 概述

LongCat API 开放平台专为 LongCat 系列模型提供 AI 模型代理服务,同时兼容 OpenAIAnthropic API 格式。本文档遵循标准 API 格式约定。

所有接口均通过统一生产环境端点 https://api.longcat.chat 访问,使用 Bearer Token 鉴权。

基础 URL

https://api.longcat.chat

认证

所有 API 请求都需要在 Authorization 头中使用 API 密钥进行认证:

http
Authorization: Bearer YOUR_API_KEY

接口一览

错误响应

API 使用常规 HTTP 响应码指示成功或失败:

状态码状态名称说明
200OK请求成功
400Bad Request请求参数无效或 JSON 格式错误
401UnauthorizedAPI 密钥无效或缺失
402Payment RequiredToken 额度不足
403ForbiddenAPI 密钥无权限访问请求资源
429Too Many Requests超出速率限制
500Internal Server Error服务器遇到意外情况
502Bad Gateway上游服务器响应无效
503Service Unavailable服务器暂时不可用

错误响应格式

所有错误返回如下结构的 JSON 对象:

json
{
  "error": {
    "message": "人类可读的错误描述",
    "type": "error_type_identifier",
    "code": "specific_error_code"
  }
}

错误类型与代码

错误类型错误代码HTTP 状态说明
authentication_errorinvalid_api_key401提供的 API 密钥无效
permission_errorinsufficient_quota403API 密钥配额不足
invalid_request_errorinvalid_parameter400参数值无效
invalid_request_errorinvalid_json400JSON 格式无效
rate_limit_errorrate_limit_exceeded429短时间内请求过多
server_errorinternal_error500服务器内部错误

速率限制

速率限制按 API 密钥执行。超出限制时会收到 429 状态码。

SDK 兼容性

本 API 设计兼容:

  • OpenAI Python SDK(用于 /openai/ 端点)
  • Anthropic Python SDK(用于 /anthropic/ 端点)
  • 任何支持相应 API 格式的 HTTP 客户端

需要帮助?请查阅 常见问题 获取常见问题和故障排查指南。