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

# Moxus AI 概述

> Moxus AI 是统一的大语言模型 API 网关。你可以用一个 API 密钥接入多家模型供应商，并通过 OpenAI、Anthropic 与 Gemini 兼容协议调用模型。

Moxus AI 是统一的大语言模型（LLM）API 网关。你可以通过一个 API 密钥和一组兼容协议端点，访问来自 OpenAI、Anthropic、Google、DeepSeek、通义千问、智谱、MiniMax、xAI 等多家供应商的模型服务。

<Info>
  平台访问地址为 `https://moxus.ai`。OpenAI 兼容接口使用 `https://moxus.ai/v1`，Anthropic 兼容接口使用 `https://moxus.ai`，Gemini 兼容接口使用 `https://moxus.ai/v1beta`。
</Info>

<Columns cols={2}>
  <Card title="从零开始调用" icon="rocket" href="/overview/quickstart">
    注册账户、创建 API 密钥，并用 cURL 或 Python 完成首次模型调用。
  </Card>

  <Card title="接入第三方客户端" icon="monitor-cog" href="/integrations/clients">
    在 ChatBox、Cursor、OpenCat 等客户端中配置 Base URL 和 API Key。
  </Card>

  <Card title="接入 SDK" icon="code-xml" href="/integrations/sdks">
    使用 Python、Node.js、Go、Java 或 LangChain 连接平台接口。
  </Card>

  <Card title="理解费用" icon="wallet-cards" href="/overview/models-and-pricing">
    查询模型名称、价格、分组倍率，并通过用量日志复盘成本。
  </Card>
</Columns>

## 产品定位

在传统模式下，接入多家模型供应商需要分别注册账户、管理各自的密钥、对接各自的接口协议并单独结算费用。Moxus AI将上述工作统一到单一平台之下：用户仅需完成一次集成，即可访问所有已接入的模型。平台兼容 OpenAI、Anthropic 与 Google Gemini 三种主流接口协议，用户现有的 SDK 与工具链无需改造即可继续使用。

<Tip>
  如果你的项目已经使用 OpenAI SDK，通常只需要把 `base_url` 改为 `https://moxus.ai/v1`，并替换为平台创建的 API 密钥。
</Tip>

## 适合的使用场景

* 需要在同一项目中按任务切换不同模型，例如对话、推理、图像、视频与嵌入模型。
* 希望第三方客户端、业务系统和自动化脚本共用统一的 API 密钥管理与账单入口。
* 需要通过用量日志追踪每次请求的模型、Token、费用和失败原因。
* 希望保留现有 OpenAI/Anthropic/Gemini SDK 调用方式，同时减少多供应商接入成本。

## 核心能力

### 统一集成

用户无需重写代码或维护多套凭证，即可访问各供应商的模型。在使用 OpenAI 兼容协议的前提下，切换模型仅需修改请求中的模型名称，其余代码无需变更。

### 多协议兼容

平台同时支持三种接口协议，均可通过同一域名与同一 API 密钥访问：

| 协议                  | 基础 URL                    |
| ------------------- | ------------------------- |
| OpenAI 兼容           | `https://moxus.ai/v1`     |
| Anthropic（Claude）兼容 | `https://moxus.ai`        |
| Google（Gemini）兼容    | `https://moxus.ai/v1beta` |

<Check>
  同一个 API 密钥可用于上述兼容协议。实际可调用模型取决于账户分组、密钥限制与平台开放模型列表。
</Check>

### 按量计费

平台按实际用量（Token 数量或调用次数）计费，所有供应商的消费合并至单一账户余额与账单，无固定月费。

### 标准参数

平台透传 OpenAI 与 Anthropic 的标准请求参数。用户现有的提示词与参数配置可直接沿用，无需为适配网关而额外调整。

### 多模态支持

在所选模型支持的前提下，平台提供以下多模态能力：

* 图像理解（图像转文本）：对输入图像进行描述、分析与识别。
* 图像生成（文本转图像）：根据文本描述生成图像。
* 图像编辑（图像转图像）：基于已有图像进行修改。
* 其他能力：通过专用接口调用 Midjourney、Suno 等服务。

### 高可用与容错

同一模型可由多个后端通道共同支撑。当某一通道发生故障或触发限流时，平台会自动切换至其他可用通道并重试，以提高请求成功率。该机制对用户透明，用户侧始终以单一模型的形式调用。

### 用量可追溯

每次调用的 Token 消耗、费用及成功状态均逐条记录于用量日志，可随时查询。

## 能力概览

| 能力    | 说明                  | 相关文档                                        |
| ----- | ------------------- | ------------------------------------------- |
| 文本对话  | 对话、写作、翻译、代码生成、摘要、问答 | [快速入门](/zh/overview/quickstart)             |
| 流式输出  | 增量返回响应内容            | [流式输出](/zh/guide/streaming)                 |
| 函数调用  | 由模型触发外部工具调用         | [函数调用](/zh/guide/function-calling)          |
| 结构化输出 | 约束模型返回规范 JSON       | [结构化输出](/zh/guide/structured-output)        |
| 推理模型  | 深度推理，推理强度可控         | [推理模型](/zh/guide/reasoning)                 |
| 视觉理解  | 对输入图像进行理解与分析        | [视觉与图像生成](/zh/guide/vision-and-image)       |
| 图像生成  | 文生图、图生图、图像编辑        | [视觉与图像生成](/zh/guide/vision-and-image)       |
| 向量嵌入  | 文本向量化，用于检索与知识库      | [向量嵌入与重排序](/zh/guide/embeddings-and-rerank) |
| 重排序   | 对候选结果按相关度排序         | [向量嵌入与重排序](/zh/guide/embeddings-and-rerank) |

## 系统架构

Moxus AI采用网关架构，位于用户应用与各模型供应商之间，负责请求认证、限流、计费、日志记录、协议转换与路由容错。

```text theme={null}
用户应用 / 客户端 / SDK
        |
        | 标准协议请求（OpenAI / Anthropic / Gemini）
        v
+---------------------------------------+
|              Moxus AI网关               |
|   认证 · 限流 · 计费 · 日志           |
|   智能路由 · 协议转换 · 自动容错      |
+---------------------------------------+
        |
        | 转换为供应商原生协议
        v
OpenAI · Anthropic · Google · DeepSeek
通义千问 · 智谱 · MiniMax · xAI · 等
```

请求处理流程如下：

1. 用户应用以标准协议（OpenAI、Anthropic 或 Gemini）发起请求。
2. 网关验证密钥、检查账户余额与访问权限，并记录日志。
3. 网关将请求转换为目标供应商的原生协议后转发。
4. 网关接收供应商响应，转换回标准协议返回给用户，并结算本次调用费用。

技术栈说明：

* 后端：Go 语言与 Gin 框架。
* 前端：React 19。
* 网关内核：基于开源项目 New API（作者 QuantumNous）。

## 后续步骤

* 开始使用：参阅 [快速入门](/zh/overview/quickstart)。
* 了解模型与价格：参阅 [模型与定价](/zh/overview/models-and-pricing)。
* 使用第三方客户端：参阅 [第三方客户端接入](/zh/integrations/clients)。