Developer Guide

8L5 API 接入文档

Laravel 负责前台、后台和业务数据管理，Go 网关负责鉴权、限流、负载均衡、熔断、重试和请求转发。

一、产品介绍

8L5 API 面向需要统一接入大模型的开发者和团队。业务系统只保留一套 API 地址和一套用户密钥，上游模型密钥与服务状态在后台集中维护。

二、核心能力

能力	说明
Bearer 鉴权	Go 网关读取 users.api_key 校验用户身份。
模型路由	根据 providers 表中的 model_name 匹配上游通道。
负载均衡	同模型多通道通过 Redis 轮询分配。
限流配额	按用户维度进行令牌桶限流和每日 Token 统计。
熔断重试	上游故障时跳过故障通道并按配置重试。

三、快速开始

注册账号并进入用户控制台。
复制控制台中的 API Key。
管理员在后台配置并启用模型通道。
使用统一接口发起请求。

四、接口地址

GET  https://api.8l5.com/v1/models
POST https://api.8l5.com/v1/responses
POST https://api.8l5.com/v1/messages
POST https://api.8l5.com/v1/chat/completions

公开网关域名为 api.8l5.com，Nginx 将 /v1/ 和 /api/ 反向代理到 Go 网关：

proxy_pass http://127.0.0.1:18080;

五、请求示例

curl https://api.8l5.com/v1/responses \
  -H "Authorization: Bearer 用户控制台里的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-4",
    "input": "你好"
  }'

curl https://api.8l5.com/v1/messages \
  -H "x-api-key: 用户控制台里的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

六、常见错误

状态码	含义	处理建议
401	API Key 无效	检查 Authorization 请求头和用户状态。
402	每日 Token 配额已用完	调整配额或等待重置。
429	触发限流	降低并发或调整网关配置。
502	上游不可用	检查后台模型配置和上游官方状态。