文档开始使用介绍
介绍
SoleAPI 是什么、基础地址与三种接口方言总览。
SoleAPI 是一个多模型 AI 网关：用一把 API Key、一个稳定入口调用 Claude、GPT、Gemini、Grok、DeepSeek 等主流模型。网关内置智能路由与故障转移、按 token 计费、限流与配额治理、请求脱敏与实时用量统计。
基础地址
所有请求都发往同一个域名：
https://api.soleapi.com使用官方 SDK 时只需把 base_url 指向上面的地址，其余代码不用改。
三种接口方言
网关同时暴露三家的接口形状，同一把 Key 通用。选你现有代码/工具在用的那家即可：
| 方言 | 入口 | 鉴权头 | 典型客户端 |
|---|---|---|---|
| OpenAI 兼容 | POST /v1/responses | Authorization: Bearer | OpenAI SDK · Codex |
| Anthropic 兼容 | POST /v1/messages | x-api-key | Anthropic SDK · Claude Code |
| Gemini 兼容 | POST /v1beta/models/{model}:generateContent | x-goog-api-key | Google GenAI SDK |
网关在必要时做协议转换，多数对话模型可以从任一方言调用；个别模型只接受特定协议时会返回明确的错误说明（见错误码）。
核心能力
- 智能路由与故障转移：多货源自动选路，单一上游故障时自动切换并熔断恢复。
- 按 token 计费：输入/输出（含缓存与推理 token）分别计价，余额与每笔流水可查。
- 限流与配额：RPM/并发限制、Key 级消费额度（可周期重置）、IP 白名单。
- 数据脱敏与内容合规：可配置的隐私过滤在转发前脱敏敏感字段，内容审核拦截风险请求。
- 实时可观测：仪表盘趋势、按 Key 用量统计、逐请求明细日志。