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

CapabilityDescription
Multi-protocol accessOpenAI-compatible (Chat, Responses, Embeddings, Images, Audio, Videos, Files, Realtime, Live), Anthropic Messages, native Gemini, and the full DeepSeek API suite
Multiple providersOpenAI, Azure, Anthropic, Gemini, Vertex AI, xAI, DeepSeek, Alibaba Cloud, Volcano Engine Ark, Zhipu, Moonshot, and more, plus any OpenAI-compatible service
Routing and fault toleranceKey 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 treeTenant isolation, unlimited levels of sub-accounts, credit transfers, inheritance and narrowing, and DNA lineage queries
Access controlIP, endpoint, and model allowlists; daily and monthly credit limits; six-dimension rate limits including account-level and model-level RPM/TPM
Metering and billingItemized 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 consolesAdmin Console (upstreams, routing, pricing, notifications) and Manage Console (usage, billing, sub-accounts, credit), in Chinese and English
SecurityPer-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

PositioningURL
XSIThis project: a source-available, commercially licensed, high-performance AI API router you can self-hostgithub.com/xabcstack/xsi
XSI official siteThe official XSI website, which also runs a commercial AI API service built on XSI; sign up and start calling modelsxsirouter.com
XSI ControlThe multi-tenant cloud service for XSI: open a tenant, add your own upstream keys, and start using it with no deploymentxsicontrol.com
XAI Router / YAI RouterCommercial AI API services that extend XSI with subscription-to-API capabilitiesxairouter.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 Labs attribution 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].

Next steps