快速开始

选择方式

方式适合你需要准备
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 池、路由配置、价格与账号树。

  1. 在 a.xsicontrol.com 用邮箱注册,打开激活邮件中的链接完成激活,页面会显示你的租户所有者 API Key。
  2. 用该 Key 登录配置管理控制台(a.xsicontrol.com),在“模型服务”中录入你自己的上游 Key(BYOK),例如 OpenAI 放 Level 1、Anthropic 放 Level 2,系统会自动生成对应的 LEVEL_MAPPER。
  3. 在账户管理控制台(m.xsicontrol.com)为团队成员或客户创建子账号并分配额度,应用使用子账号的 Key 调用。
  4. 设置环境变量:
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

随后:

  1. 为 API 与两个控制台配置 HTTPS 反向代理,见《反向代理》。
  2. 用 root Key(INIT_USERS 中的 sk-Xvs...)登录配置管理控制台,在“模型服务”中添加上游 Key。
  3. 在账户管理控制台创建子账号并分配额度,用子账号的 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"

也可以在账户管理控制台查看实时用量、账单与模型明细。

下一步