API 文档
Tabbit Proxy 完全兼容 OpenAI Chat Completions API v1 规范。
认证方式
场景 A:配置了 API_KEY
Bearer 用于本地鉴权,Tabbit 凭据取自环境变量。
Authorization: Bearer <API_KEY>
场景 B:未配置 API_KEY
Bearer 直接作为 Tabbit token 字符串(格式:token|session|device_id)。
Authorization: Bearer <TABBIT_TOKEN>|<SESSION>|<DEVICE_ID>
接口列表
GET
/v1/models
获取可用模型列表。
{"object":"list","data":[{"id":"best","object":"model","owned_by":"tabbit"},...]}
POST
/v1/chat/completions
对话请求,支持流式与非流式。
{"model":"best","messages":[{"role":"user","content":"你好"}],"stream":false}
best gpt-5.2-chat gpt-5.1-chat gemini-3.1-pro gemini-3-flash gemini-2.5-flash claude-sonnet-4.6 claude-haiku-4.5 glm-5 deepseek-v3.2 minimax-m2.5 kimi-k2.5 qwen3.5-plus doubao-seed-1.8
GET
/api/metrics
获取服务运行指标与最近 10 条请求记录(JSON)。
环境变量
| 变量名 | 说明 | 必填 |
|---|---|---|
| TABBIT_TOKEN | JWT access token(Cookie token= 的值) | 二选一 |
| TABBIT_SESSION | next-auth session token | 可选 |
| TABBIT_DEVICE_ID | 设备 UUID(省略则自动生成) | 可选 |
| API_KEY | 本地服务访问密钥 | 可选 |
| PORT | 监听端口(默认 8800) | 可选 |