快速开始
选择方式
| 方式 | 适合 | 你需要准备 |
|---|---|---|
| XSI Control 多租户云 xsicontrol.com | 使用自己的上游 Key,但不想部署 | 邮箱、上游 Key |
| XSI 官方服务 xsirouter.com | 直接调用模型,不想维护任何上游 Key | 邮箱 |
| 自行部署 XSI | 完全掌控数据与运营 | 一台 Linux 主机、域名、上游 Key |
三种方式的 API 完全一致,下文示例只需替换 XSI_BASE_URL 与 XSI_API_KEY。
路径一:开通 XSI Control 租户
XSI Control 是 XSI 的多租户云服务。每个租户拥有独立的上游 Key 池、路由配置、价格与账号树。
- 在 a.xsicontrol.com 用邮箱注册,打开激活邮件中的链接完成激活,页面会显示你的租户所有者 API Key。
- 用该 Key 登录配置管理控制台(a.xsicontrol.com),在“模型服务”中录入你自己的上游 Key(BYOK),例如 OpenAI 放 Level 1、Anthropic 放 Level 2,系统会自动生成对应的
LEVEL_MAPPER。 - 在账户管理控制台(m.xsicontrol.com)为团队成员或客户创建子账号并分配额度,应用使用子账号的 Key 调用。
- 设置环境变量:
export XSI_BASE_URL="https://api.xsicontrol.com"
export XSI_API_KEY="sk-Xvs..."上游 Key 以租户密钥加密存储,租户密钥由你的 API Key 包裹,见《架构》。
路径二:自行部署
git clone https://github.com/xabcstack/xsi.git && cd xsi
umask 077 && cp docker-compose.example.yml docker-compose.yml
sed -i "s/CHANGE_ME_POSTGRES_PASSWORD/$(openssl rand -hex 24)/g" docker-compose.yml
sed -i "s/CHANGE_ME_ROOT_KEY/sk-Xvs$(openssl rand -hex 24 | cut -c1-45)/" docker-compose.yml
# 编辑 docker-compose.yml:域名、root 邮箱与 SMTP
docker compose up -d随后:
- 为 API 与两个控制台配置 HTTPS 反向代理,见《反向代理》。
- 用 root Key(
INIT_USERS中的sk-Xvs...)登录配置管理控制台,在“模型服务”中添加上游 Key。 - 在账户管理控制台创建子账号并分配额度,用子账号的 Key 调用。
完整步骤见《Docker Compose 部署》。
export XSI_BASE_URL="https://api.example.com"
export XSI_API_KEY="<子账号 Key>"发出第一个请求
示例中的模型名需已在价格表中配置,且你的账号有权使用。可用 GET /v1/models 或 GET /x-pricing 查看。
OpenAI Responses
curl "$XSI_BASE_URL/v1/responses" \
-H "Authorization: Bearer $XSI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.2-sol", "input": "用一句话介绍你自己"}'OpenAI Chat Completions
curl "$XSI_BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer $XSI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.2-sol", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'Anthropic Messages
curl "$XSI_BASE_URL/v1/messages" \
-H "x-api-key: $XSI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-5-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'Gemini
curl "$XSI_BASE_URL/v1beta/models/$GEMINI_MODEL:generateContent" \
-H "x-goog-api-key: $XSI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "用一句话介绍你自己"}]}]}'DeepSeek
curl "$XSI_BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer $XSI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-flash", "messages": [{"role": "user", "content": "用一句话介绍你自己"}]}'查看用量
curl "$XSI_BASE_URL/dashboard/live" -H "Authorization: Bearer $XSI_API_KEY"也可以在账户管理控制台查看实时用量、账单与模型明细。
下一步
- SDK 集成:Python、Node.js 与各类客户端
- Router API:全部模型接口
- 账号体系:为团队或客户创建子账号
- 路由与故障转移:配置多上游与容灾