995api Logo 995api Docs
控制台 法律与安全
API Reference

接口与鉴权

995api 采用 OpenAI 兼容的 HTTP API 形式。接口可用性可能因模型、账户分组和具体能力而不同。

鉴权

在请求头中发送 API Key：

HTTP Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
不要在浏览器前端公开 API Key。生产应用应由服务端持有密钥，或使用能够安全保护凭据的受控客户端。

常用接口

接口用途说明
GET /v1/models模型列表返回当前 API Key / 账户实际可见的模型。
POST /v1/chat/completions聊天补全兼容主流 OpenAI Chat Completions 调用方式。
POST /v1/responsesResponses API仅在目标模型与当前服务能力支持时可用；客户端应处理不支持的情况。

Responses API

如果当前账户可见模型支持 Responses API，可使用以下形式。不要假设所有模型都支持所有参数。

cURL
curl https://api.995223.xyz/v1/responses   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "YOUR_MODEL",
    "input": "Hello"
  }'

错误处理

状态码常见含义建议
400请求格式或参数错误检查 JSON、模型参数和接口兼容性。
401鉴权失败检查 API Key、Bearer 格式与密钥状态。
403权限或安全策略拒绝检查账户权限、模型分组及安全策略。
429触发速率或资源限制降低并发，使用指数退避后重试。
5xx服务暂时异常使用退避重试；持续异常时联系管理员。

重试建议

仅对网络超时、429 和部分 5xx 使用有限次数的指数退避。对于 400、401、403 等确定性错误，不应无限重试。