Introduction
xsicontrol.com is XSI Control, the multi-tenant cloud edition of XSI: open a tenant, bring your own upstream keys and use every capability without deploying anything. This documentation applies to both XSI Control and self-hosted XSI.
What is XSI
XSI is a high-performance, multi-tenant AI API router. It puts OpenAI, Anthropic, Google, xAI, DeepSeek, and other model providers behind a single endpoint and, while keeping every protocol native, provides routing and fault tolerance, accounts and permissions, and metering and billing.
An application needs only one XSI API key and one base_url change to reach every connected model through the official SDKs and tools such as Codex and Claude Code. Upstream keys, routing policies, credit, and pricing are governed centrally on the server side by the operator.
Design principles
- Protocol-native: XSI does not invent a unified format. It preserves the full request and response semantics of OpenAI Chat Completions, Responses (including WebSocket mode), Anthropic Messages, the native Gemini API, Realtime, and more. New upstream parameters and fields work immediately, with no adaptation required.
- Performance first: Written in Go. The hot path runs entirely in memory, streaming responses are passed through with zero buffering, and metering and settlement run asynchronously.
- Minimal intervention: Requests are rewritten only where routing, isolation, or billing requires it; everything else passes through unchanged.
- Built-in governance: The account tree, credit, allowlists, rate limits, billing, and auditing are part of the core model, not add-ons.
Core capabilities
| Capability | Description |
|---|---|
| Multi-protocol access | OpenAI-compatible (Chat, Responses, Embeddings, Images, Audio, Videos, Files, Realtime, Live), Anthropic Messages, native Gemini, and the full DeepSeek API suite |
| Multiple providers | OpenAI, Azure, Anthropic, Gemini, Vertex AI, xAI, DeepSeek, Alibaba Cloud, Volcano Engine Ark, Zhipu, Moonshot, and more, plus any OpenAI-compatible service |
| Routing and fault tolerance | Key pools grouped by model, model mapping, sticky sessions, automatic server-side retries, key sleep and auto-disable, Level failover, and model failover |
| Multi-tenancy and account tree | Tenant isolation, unlimited levels of sub-accounts, credit transfers, inheritance and narrowing, and DNA lineage queries |
| Access control | IP, endpoint, and model allowlists; daily and monthly credit limits; six-dimension rate limits including account-level and model-level RPM/TPM |
| Metering and billing | Itemized billing for tokens, cache reads and writes, reasoning, images, video seconds, audio duration, search, and tool calls; fast tiers and long-context tiers; tenant price overrides |
| Two consoles | Admin Console (upstreams, routing, pricing, notifications) and Manage Console (usage, billing, sub-accounts, credit), in Chinese and English |
| Security | Per-tenant encrypted storage of upstream keys, credential isolation, authentication protection, and signup abuse prevention |
Use cases
- Internal enterprise AI gateway: Procure upstream resources centrally, allocate credit by department and project, control models and costs, and audit in one place.
- AI API service: Offer model APIs under your own brand, set pricing, credit, and permissions per customer, and support multi-tier resale.
- Multi-tenant BYOK platform: Each tenant brings its own upstream keys and manages its own accounts, configuration, and pricing independently.
- Developer tool access: Provide a single endpoint and usage governance for tools such as Codex and Claude Code.
Products and services
| Positioning | URL | |
|---|---|---|
| XSI | This project: a source-available, commercially licensed, high-performance AI API router you can self-host | github.com/xabcstack/xsi |
| XSI official site | The official XSI website, which also runs a commercial AI API service built on XSI; sign up and start calling models | xsirouter.com |
| XSI Control | The multi-tenant cloud service for XSI: open a tenant, add your own upstream keys, and start using it with no deployment | xsicontrol.com |
| XAI Router / YAI Router | Commercial AI API services that extend XSI with subscription-to-API capabilities | xairouter.com Β· yairouter.com |
Architecture overview
Apps / SDKs / Codex / Claude Code
β XSI API Key
βΌ
ββββββββββββββββββββββββββ
β XSI β Auth β Admission β Model mapping β Level routing β Key pool
β Data + control plane β β Retry and failover β Metering and billing
ββββββββ¬βββββββββββ¬βββββββ
β β
PostgreSQL Redis
β
βΌ
OpenAI Β· Anthropic Β· Gemini Β· xAI Β· DeepSeek Β· Azure Β· Vertex Β· ...See Architecture for details.
License
XSI is released under the XSI Source-Available License:
- Free for personal, non-commercial use: learning, research, experimentation, and personal use.
- A commercial license is required for enterprise production use and any other commercial use: CNY 2,400 per licensed entity per year. This includes paid APIs or paid services operated by individuals.
- All users must retain the
XSI by XABC Labsattribution and the link to the original project. - The top broadcast bar and promotional card that the consoles show by default carry content provided by XABC Labs. They help fund XSI's continued development and operation and are what allows XSI to be offered free to individuals. Without a commercial license they must be kept as they are; a commercial license can agree to adjust or disable them.
See the commercial licensing terms. Questions: [email protected].