# Xcity AI OS

> The OS for a solar-powered AI civilization. OpenAI-compatible inference, identity, billing, and a four-hub product platform.

## Docs

### English

- [Auth API](https://xcity.ai/docs/en/api-reference/auth): Session, registration, password, and identity endpoints exposed by xcity-home.
- [Billing API](https://xcity.ai/docs/en/api-reference/billing): Plan, checkout, portal, and invoice endpoints backed by Stripe.
- [Inference API](https://xcity.ai/docs/en/api-reference/inference): OpenAI-compatible chat, completions, and embeddings endpoints served by tokenhub.xcity.one.
- [Keys API](https://xcity.ai/docs/en/api-reference/keys): Provision, list, and revoke inference API keys programmatically.
- [Architecture Overview](https://xcity.ai/docs/en/concepts/architecture): How identity, billing, and inference flow through the Xcity stack.
- [Authentication flow](https://xcity.ai/docs/en/concepts/auth-flow): How sessions, cookies, and identity are propagated across xcity.one and its sub-products.
- [Using LLMs and agents with Xcity docs](https://xcity.ai/docs/en/concepts/llms-and-ai): Drop-in context for AI assistants — llms.txt, semantic anchors, structured references.
- [Plans, keys, and budgets](https://xcity.ai/docs/en/concepts/plans): How accounts map to plans, how keys are scoped, and how usage is metered.
- [Data residency (Enterprise)](https://xcity.ai/docs/en/enterprise/data-residency): Region pinning options and the dedicated-cluster deployment model.
- [Enterprise onboarding playbook](https://xcity.ai/docs/en/enterprise/onboarding-playbook): What happens between signing the order form and your first production traffic.
- [Procurement & contracts](https://xcity.ai/docs/en/enterprise/procurement): How to buy Xcity at the enterprise tier — paper, security review, SSO, invoicing.
- [Service Level Agreement](https://xcity.ai/docs/en/enterprise/sla): Uptime, latency, and support response commitments for paid plans.
- [Status & incident communication](https://xcity.ai/docs/en/enterprise/status-page): Where to watch operational state and how we communicate during incidents.
- [Support tier matrix](https://xcity.ai/docs/en/enterprise/support-matrix): Channels, response targets, and what each support tier includes.
- [Installation](https://xcity.ai/docs/en/get-started/installation): SDK install steps for Node.js, Python, and Go clients, plus environment setup.
- [Introduction](https://xcity.ai/docs/en/get-started/introduction): What Xcity AI OS is, who it's for, and how the pieces fit together.
- [Quick Start](https://xcity.ai/docs/en/get-started/quickstart): Create an account, get an API key, and make your first inference call in under five minutes.
- [Deployment](https://xcity.ai/docs/en/guides/deployment): Deploy xcity-home to Cloudflare Pages with the Node adapter + Wrangler.
- [Desktop integration (Electron)](https://xcity.ai/docs/en/guides/desktop-integration): How xct-agent-desktop and other native apps authenticate users without browser cookies.
- [Handle Xcity webhooks](https://xcity.ai/docs/en/guides/handle-webhooks): Subscribe to plan, key, and usage events from xcity-home.
- [Integrate a browser sub-product](https://xcity.ai/docs/en/guides/sub-product-integration): Wire any *.xcity.one app into the unified identity, plan, and inference flow.
- [Runbooks](https://xcity.ai/docs/en/operations/runbooks): Step-by-step procedures for common operational tasks and incidents.
- [Secrets & environment](https://xcity.ai/docs/en/operations/secrets): Every secret xcity-home needs, where it lives, and how to rotate it.
- [Stripe webhooks](https://xcity.ai/docs/en/operations/stripe-webhooks): How billing events flow into xcity-home, what can fail, and how to replay.
- [Test dashboard](https://xcity.ai/docs/en/operations/test-dashboard): Where to read pass-rate, flake, and coverage trends from the Playwright suite.
- [Test framework](https://xcity.ai/docs/en/operations/testing): How the Playwright test suite is structured, run, and aggregated.
- [AI Platform](https://xcity.ai/docs/en/products/ai-platform): The four-hub Xcity AI platform — Builder, Exchange, Agent, Runtime.
- [Energy Platform](https://xcity.ai/docs/en/products/energy-platform): 100 GW solar compute zone — capacity model, contracts, and developer access.
- [Data residency](https://xcity.ai/docs/en/security/data-residency): Where customer data lives, what crosses borders, and how to constrain it.
- [Security & Compliance](https://xcity.ai/docs/en/security/overview): Encryption, residency, audit posture, and how to request compliance artifacts.

### 中文

- [推理 API](https://xcity.ai/docs/zh/api-reference/inference): tokenhub.xcity.one 提供的 OpenAI 兼容 chat/completions、completions、embeddings 端点。
- [架构总览](https://xcity.ai/docs/zh/concepts/architecture): 身份、计费、推理三个平面如何在 Xcity 栈中流转。
- [计划、密钥与预算](https://xcity.ai/docs/zh/concepts/plans): 账户如何映射到计划，密钥如何作用域化，用量如何计量。
- [服务等级协议](https://xcity.ai/docs/zh/enterprise/sla): 付费计划的可用性、延迟、支持响应承诺。
- [简介](https://xcity.ai/docs/zh/get-started/introduction): Xcity AI OS 是什么、面向谁、各部分如何组合。
- [快速开始](https://xcity.ai/docs/zh/get-started/quickstart): 注册账户、获取 API Key、5 分钟内完成首个推理调用。
- [接入浏览器子产品](https://xcity.ai/docs/zh/guides/sub-product-integration): 把任意 *.xcity.one 应用接入统一身份、计划与推理。

## Reference URLs

- Marketing: https://xcity.ai/
- Pricing: https://xcity.ai/pricing
- Inference gateway: https://tokenhub.xcity.one/v1
- Status: https://status.xcity.one
- Contact: enterprise@xcity.one