> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xuwuai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 概览

> Xuwu API 的基础入口、认证方式与常用能力导航

# API 概览

Xuwu 对外提供三类常用接口：

* **模型调用 API**：使用模型调用 Token，主要访问 `/v1/*`、`/minimaxi/*`、`/kling/*`、`/vidu/*`、`/volcark/*` 等模型能力路径。
* **账号与控制台 API**：使用个人资料访问令牌，主要用于账号余额、个人资料等控制台数据查询。
* **查询授权 API**：使用查询授权 Token，主要访问 `/api/query/v1/*`，用于只读查询余额、日志、异步任务、用户、客户价格、渠道和渠道错误等数据。可读范围分为**当前用户**、**指定用户**、**全部用户**。

## 基础地址

```bash theme={null}
export BASE_URL="https://xuwuai.com"
export TOKEN="你的模型调用 Token"
```

## 常用能力

<CardGroup cols={2}>
  <Card title="OpenAI 兼容接口" icon="terminal" href="/openai/overview">
    Chat Completions、Responses、图像、音频、视频、Realtime 等。
  </Card>

  <Card title="阿里百炼开发者 API" icon="cloud" href="/bailian/api">
    面向平台开发者的百炼北京站 API 契约、SDK base\_url、模型和验收入口。
  </Card>

  <Card title="MiniMaxi" icon="film" href="/minimaxi/overview">
    视频生成、语音合成、音色复刻与文件管理。
  </Card>

  <Card title="Kling" icon="sparkles" href="/kling/overview">
    可灵视频、图像与视频编辑能力。
  </Card>

  <Card title="Gemini" icon="gem" href="/gemini/overview">
    Gemini 原生与 OpenAI 兼容接口。
  </Card>
</CardGroup>

## 认证与排查

<CardGroup cols={2}>
  <Card title="API 认证" icon="key" href="/guide/authentication">
    区分模型调用 Token、个人资料访问令牌与查询授权 Token。
  </Card>

  <Card title="请求追踪" icon="route" href="/guide/request-id">
    使用请求 ID 定位 API 调用问题。
  </Card>

  <Card title="错误处理" icon="triangle-alert" href="/guide/errors">
    了解平台错误响应结构与常见错误码。
  </Card>

  <Card title="计费对账" icon="receipt" href="/guide/billing-reconciliation">
    对齐调用记录、usage 与消费日志。
  </Card>

  <Card title="查询授权" icon="key" href="/guide/query-authorization">
    给外部系统签发只读查询 Token。
  </Card>
</CardGroup>