---
title: "XiuRouter 文档首页"
description: "使用 Chat Completions、Responses、Anthropic Messages 或 Gemini GenerateContent 调用模型，并把开发工具接入 XiuRouter。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# XiuRouter 文档首页

XiuRouter 是独立的模型 API 服务。你可以登录控制台、充值、创建受限的 API Key，再通过 Chat Completions、Responses、Anthropic Messages 或 Gemini GenerateContent 调用当前目录中的模型。新接入应把控制台和 API 地址分开配置。

- **发起第一次请求** — 创建 API Key，读取模型列表，再调用 Chat
Completions。[开始调用](/router/quickstart)
- **确认 API 兼容范围** — 查看 OpenAI Chat Completions、Responses、Anthropic Messages、Gemini GenerateContent
路由和当前限制。[查看兼容范围](/router/api-compatibility)
- **接入开发工具** — 按客户端使用的协议选择 Codex、Claude Code、Open WebUI、Aider
等工具。[选择集成方式](/router/integrations)
- **查看模型与价格** — 模型、服务档位和单价会变化，调用前以控制台当前目录为准。[打开价格页](https://router.xiu.ai/pricing)

## 先分清两个地址

| 用途 | 地址 | 说明 |
| --- | --- | --- |
| 控制台 | `https://router.xiu.ai` | 登录、充值、创建 API Key、查看价格和使用记录 |
| Chat Completions / Responses | `https://router-api.xiu.ai/v1` | OpenAI 兼容 SDK 和使用 Responses 的客户端 |
| Anthropic Messages | `https://router-api.xiu.ai` | 会自行追加 `/v1/messages` 的 Claude 客户端 |
| Gemini GenerateContent | `https://router-api.xiu.ai` | 会自行追加 `/v1beta/models/...` 的 Gemini 客户端 |

`router-api.xiu.ai` 让模型请求直连服务节点，不经过控制台的边缘转发。对中国大陆网络，这条链路通常更短、延迟更低，也更适合长流式响应。实际速度仍会受地区、运营商和当前网络影响。

`router.xiu.ai/v1` 仍保留兼容转发，已有配置不会立即失效。新配置应使用 `router-api.xiu.ai`，避免长请求受到边缘转发超时影响。

## 从其他 API 服务切换

如果当前客户端使用 OpenAI Chat Completions 或 Responses，通常只需要替换两项：

```text
Base URL: https://router-api.xiu.ai/v1
API Key: 你的 XiuRouter API Key
```

目标模型 ID 在 XiuRouter 中相同时，原模型配置可以保留；目录中没有相同 ID 时，还需要改为 XiuRouter 当前提供的模型 ID。

使用 Anthropic Messages 的客户端时，Base URL 使用 `https://router-api.xiu.ai`，不要追加 `/v1`；客户端会自行请求 `/v1/messages`。Gemini GenerateContent 客户端也使用 API 根地址，由客户端追加 `/v1beta/models/{model}:generateContent`。API Key 填入客户端对应的 Key 或 Token 配置项。接入前先查看[API 兼容范围](/router/api-compatibility)。

## 从哪里开始

1. 第一次使用：阅读[发起第一次 API 请求](/router/quickstart)。
2. 已有兼容客户端：按 Chat Completions、Responses、Anthropic Messages 或 Gemini GenerateContent 替换对应 Base URL 和 API Key，再确认模型 ID 可用。
3. 使用 SDK：阅读[使用 SDK 调用 XiuRouter](/router/sdk-and-requests)，再按模型验证请求参数。
4. 使用 Codex、Claude Code 或 Agent 工具：先阅读[选择集成方式](/router/integrations)，不要只替换域名。
5. 准备生产接入：完成[错误处理与生产检查](/router/errors-and-production)。
6. 请求失败：先确认 API 地址、认证头、模型 ID、API Key 的分组和模型限制，再查使用记录。

## 当前边界

- 模型、分组、价格和可用性以[模型与价格](https://router.xiu.ai/pricing)当前显示为准。
- 分组表示服务来源与价格，不代表速度、质量或服务等级。
- 同一个模型不一定支持所有协议。客户端协议必须和网关路由、模型能力同时匹配。
- 公共目录的协议声明当前不足以单独判断 Responses 或 Gemini 是否可用；用目标模型和分组发送小请求确认。
- 本轮核对确认了公开路由和未认证请求的拒绝行为，没有使用真实 API Key 发起计费调用。
- 不要把 API Key 写进仓库、截图、聊天记录或共享配置。

## 来源与核对日期

本文按 XiuRouter 当前控制台、公开状态、价格接口和 `xiu-router`、`xiu-web` 当前代码核对，日期为 2026-08-19。模型、价格和客户端版本会变化，接入时以控制台与对应项目官方文档为准。

源文件：https://docs.xiu.ai/router/index.mdx