ATUAI 文档中心

统一接入多种 AI 模型，支持 OpenAI 兼容格式。把客户端里的接口地址和 API Key 替换为 ATUAI，即可在常用工具和自写程序中调用模型。

平台概览

ATUAI 是一个 AI API 统一接入网关：一个密钥聚合 Claude、OpenAI、Gemini、Grok 等主流模型，采用 OpenAI 兼容协议，无需改造现有代码即可完成迁移，支持会话保持、负载均衡与按量计费。

OpenAI 兼容

现有 SDK 零改造

会话保持

粘性会话不掉线

负载均衡

多账号故障转移

按量计费

余额用多少扣多少

社区交流：如需加入用户交流群、获取平台公告与优惠活动，请在 ATUAI 控制台查看最新群二维码，或联系管理员。

快速接入

1

创建 API Key

登录 ATUAI 控制台，进入「API Keys」页面，创建并复制你的密钥。

2

填写接口地址

在客户端选择 OpenAI 兼容接口，Base URL 填写 ATUAI 地址 https://api.atuai.cn/v1。

3

选择模型

模型名称请从控制台完整复制，不要手动改写或自行猜测。

通过控制台一键导入（CCS / CC Switch）

如果你使用 CC Switch，可以直接从 ATUAI 后台导入配置，无需手动复制 Base URL 和模型参数。

  1. 登录 ATUAI 控制台，在侧边栏点击「API 密钥」。
  2. 点击右上角「创建密钥」，选择可用分组后生成 API Key。
  3. 在密钥列表右侧操作栏点击「导入到 CCS」，即可导入 CC Switch 使用。

CC Switch 可用于管理 Claude Code、Codex、Gemini CLI 等客户端配置。具体可用模型和分组以 ATUAI 控制台显示为准。
请从 官方 GitHub Releases 获取客户端，避免使用来源不明的安装包。

首次调用前核对：① API Key 已创建且处于启用状态；② 模型名称从控制台完整复制；③ Base URL 是否由客户端自动补全 /v1；④ 先发送一条短文本确认返回正常，再开启流式或高并发。

接口地址

大多数 OpenAI 兼容客户端填写下面这个地址：

https://api.atuai.cn/v1

如果软件会自动拼接 /v1，则填写：

https://api.atuai.cn

如果软件要求填写完整接口地址，可以填写：

https://api.atuai.cn/v1/chat/completions
提示：不同软件对 Base URL 的拼接方式不同。如果请求失败，可以在 https://api.atuai.cn 和 https://api.atuai.cn/v1 之间切换测试。

首次连通性测试

创建 Key 后，建议先请求模型列表。返回模型数据，说明密钥和基础地址可正常使用。

# 将 YOUR_API_KEY 替换为你的密钥
curl https://api.atuai.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

模型与分组

ATUAI 会接入多个模型渠道。不同渠道的倍率、稳定性、上下文长度和能力不同，请以控制台实际显示为准。以下为常见模型家族：

模型家族适合场景说明
GPT 系列日常聊天、写作、总结、翻译适合大多数用户优先测试
GPT-Pro / 高能力复杂推理、代码、长任务能力更强，倍率通常更高
Claude长文写作、代码分析、文档处理具体模型以后台列表为准
Gemini / DeepSeek低成本、备用、批量任务适合普通文本和批量调用
Codex / 代码模型编程、代码解释、项目修改适合开发者使用
注意：渠道名称不等于官方套餐名称。遇到 model_not_found 时，先检查模型名称是否完全正确，再换同分组其他模型测试。模型与分组请以 ATUAI 控制台实时显示为准。

分组介绍

ATUAI 当前主要提供以下两个分组，按使用场景选择：

主力分组

GPT-PRO

标准倍率 · 生产级稳定

  • 覆盖 GPT 全系列及高能力模型
  • 适合复杂推理、代码生成、长任务
  • 多账号负载均衡，故障自动转移
  • 推荐用于生产环境与高频调用
福利分组

GPT福利组

低倍率 · 仅 0.3 计费系数

  • 享受 0.3 倍率 超低成本
  • 适合日常聊天、批量调用
  • 适合成本敏感与测试场景
  • 大用量用户的实惠之选
怎么选：追求稳定与高能力用 GPT-PRO；追求极致性价比、日常大量调用用 GPT福利组（0.3 倍率）。创建密钥时选择对应分组即可，详细倍率以控制台显示为准。

客户端配置

以下客户端均使用 OpenAI 兼容模式接入 ATUAI。把接口地址改为 https://api.atuai.cn/v1，API Key 改为你的 ATUAI 密钥即可。

Cherry Studio

服务类型：OpenAI Compatible
API 地址：https://api.atuai.cn/v1
API Key：你的 ATUAI 密钥
模型：控制台显示的模型名称

NextChat

接口地址：https://api.atuai.cn
或：https://api.atuai.cn/v1
API Key：你的 ATUAI 密钥
模型：控制台显示的模型名称

Open WebUI

Base URL：https://api.atuai.cn/v1
API Key：你的 ATUAI 密钥
保存后刷新模型列表

Dify

模型供应商：OpenAI-compatible
Base URL：https://api.atuai.cn/v1
API Key：你的 ATUAI 密钥
Model：后台模型名称

Codex CLI 配置使用教程

Codex CLI 适合开发者在终端里进行代码生成、项目修改、代码解释和调试。下面以 ATUAI 为例，演示如何把 Codex CLI 配置为使用 ATUAI 的 OpenAI 兼容接口。

使用前请先在 ATUAI 控制台创建 API Key，并确认你的账号余额充足、所选模型支持代码或 Responses API。

一、准备环境

建议安装 Node.js 20 或以上版本。Windows 用户建议使用 Windows Terminal。安装完成后重新打开终端验证版本：

# 验证 Node.js 版本
node -v

二、安装 Codex CLI

# 国内镜像加速
npm config set registry https://registry.npmmirror.com
npm i -g @openai/codex
codex --version

三、配置文件位置

系统config.tomlauth.json
WindowsC:\Users\你的用户名\.codex\config.tomlC:\Users\你的用户名\.codex\auth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
项目单独配置项目目录\.codex\config.toml项目目录\.codex\auth.json

四、手动配置 config.toml

如果文件不存在就新建。如果原来已有配置，建议先备份再覆盖。

model = "请填写控制台可用的 Codex/代码模型"
model_provider = "atuai"
model_reasoning_effort = "high"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
file_opener = "vscode"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[features]
unified_exec = false

[model_providers.atuai]
name = "atuai"
base_url = "https://api.atuai.cn"
wire_api = "responses"
requires_openai_auth = true

五、配置 auth.json

把下面的 sk-... 替换成你在 ATUAI 后台创建的 API Key。

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
}

六、启动 Codex CLI

codex

日常使用 codex 即可；只有在完全可信的本地项目中，并且已理解风险时，才自行查阅官方说明决定是否开启额外权限。

七、Windows / macOS / Linux 安装

# macOS / Linux / WSL2 推荐用 Volta 管理 Node
curl https://get.volta.sh | bash
volta install node@20
npm i -g @openai/codex
codex --version

八、Codex CLI 报错处理

  • 401 Unauthorized：API Key 错误或没有写入 auth.json。请重新复制 ATUAI 后台生成的 Key。
  • 403 INSUFFICIENT_BALANCE：余额不足。请充值或切换低倍率代码模型（如 GPT福利组）。
  • model_not_found：模型名不存在或当前分组没有该模型通道。请复制控制台里的真实模型名称。
  • Responses 不支持：当前模型或上游通道不支持 Responses API。请换支持 Responses 的模型，或联系管理员确认通道能力。
  • unexpected status 502 / 正在重新连接：base_url 与 wire_api = "responses" 配置正确时，502 通常表示所选分组的上游账号、模型映射或通道暂时不可用。先换同分组模型测试，并向管理员提供模型名、报错时间和 Request ID。

Codex App 桌面客户端配置

如果你不想安装 Codex CLI，只使用 Codex App 桌面客户端，可以在用户目录下创建 .codex 文件夹，并放入 auth.json 和 config.toml 两个配置文件。

如果之前在 Codex App 里登录过自己的 OpenAI / ChatGPT 账号，请先退出当前账号再进行 ATUAI 配置。切换 API 后，旧账号空间里的历史记录不会自动迁移。

一、创建配置目录

# macOS / Linux
mkdir -p ~/.codex

Windows 路径为 C:\Users\你的用户名\.codex。若目录已有旧配置，建议先备份再替换。

二、创建 auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
}

三、创建 config.toml

model = "请填写控制台可用的 Codex/代码模型"
model_provider = "atuai"
model_reasoning_effort = "high"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
file_opener = "vscode"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[features]
unified_exec = false

[model_providers.atuai]
name = "atuai"
base_url = "https://api.atuai.cn"
wire_api = "responses"
requires_openai_auth = true

四、重启 Codex App

两个文件创建完成后，完全退出 Codex App，再重新打开。若报错里出现 api.openai.com，说明 config.toml 没生效，请检查文件名和路径。修改配置后需完全退出并重新打开。

排查：遇到报错时，请截图并提供：系统类型、Codex App 版本、报错内容、配置文件路径、使用的模型名称。不要把完整 API Key 发给任何人。

OpenClaw 安装与 ATUAI 接入

OpenClaw 适合需要本地或服务器部署网页聊天界面的用户。完成 OpenClaw 官方安装后，可以手动编辑 ~/.openclaw/openclaw.json，把 ATUAI 作为 OpenAI Responses 兼容提供商接入。

安装前请准备好 Git、Node.js 和 ATUAI 后台生成的 sk- 开头密钥。模型名称请以 ATUAI 控制台实际显示为准。

一、基础环境

git --version
node -v
npm -v

二、手动配置 openclaw.json

{
  "models": {
    "providers": {
      "atuai": {
        "baseUrl": "https://api.atuai.cn/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
        "auth": "api-key",
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          { "id": "请填写控制台中的模型名称", "name": "ATUAI 模型", "reasoning": true, "contextWindow": 400000, "maxTokens": 128000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "atuai/请填写控制台中的模型名称" },
      "workspace": "/root/.openclaw/workspace",
      "thinkingDefault": "high"
    }
  }
}

Windows 用户请不要把 /root/.openclaw/workspace 照抄，改成你自己的 OpenClaw 工作目录。修改配置后需重启 OpenClaw gateway 或主进程。

三、安装后检查

openclaw --version
openclaw gateway status
openclaw models status
常见问题：模型不可用 → 检查模型名是否和 ATUAI 控制台完全一致；余额不足 → 返回 INSUFFICIENT_BALANCE，请充值或换低倍率模型；网页打不开 → 远程服务器优先用 SSH 端口转发，不建议直接开放公网端口。

接口示例

获取模型列表

curl https://api.atuai.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat Completions

curl https://api.atuai.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请替换为控制台中的模型名称",
    "messages": [{ "role": "user", "content": "你好" }],
    "stream": true
  }'

Responses API

适用于 Codex 等使用 Responses 协议的客户端。模型是否支持该接口，请以 ATUAI 控制台的实际能力为准。

curl https://api.atuai.cn/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请替换为控制台中的模型名称",
    "input": "你好"
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.atuai.cn/v1"
)

response = client.chat.completions.create(
    model="请替换为控制台中的模型名称",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

JavaScript SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.atuai.cn/v1"
});

const response = await client.chat.completions.create({
  model: "请替换为控制台中的模型名称",
  messages: [{ role: "user", content: "你好" }]
});
console.log(response.choices[0].message.content);

充值与订单

如控制台已开启充值功能，用户可按页面提供的方式创建订单并完成充值。订单状态和余额变化请以控制台记录为准。

1

创建充值订单

在控制台选择金额和可用支付方式，确认订单金额后再进入支付页面。

2

完成支付

支付完成后请等待页面返回，避免重复创建相同金额的待支付订单。

3

核对余额

返回控制台查看订单状态和账户余额；首次到账后再开始正式调用。

订单异常：支付已完成但余额未变化时，请保留订单号、支付时间和支付截图联系管理员。不要在群内发送支付密钥、商户密钥或完整 API Key。

计费说明

平台采用按量计费。实际消耗通常和输入 tokens、输出 tokens、模型倍率、图片/文件/长上下文等能力有关。

消耗 = 模型基础消耗 × 当前模型倍率
  • 低倍率模型（如 GPT福利组 0.3 倍率）更适合日常聊天、批量处理和新手测试。
  • 高倍率模型（如 GPT-PRO 旗舰模型）更适合复杂代码、长文分析和高质量输出。
  • 余额不足时会返回 INSUFFICIENT_BALANCE。
  • 模型价格和倍率请以控制台显示为准。

常见错误

错误原因与处理
401 UnauthorizedAPI Key 错误、缺失或已被删除。检查请求头是否包含 Authorization: Bearer YOUR_API_KEY。
403 INSUFFICIENT_BALANCE账户余额不足。请充值，或切换低倍率模型（如 GPT福利组）。
403 Access Denied访问策略、地区策略、账号状态或风控限制。请检查网络环境和平台公告。
404 / 503 model_not_found模型名称错误，或当前分组没有该模型可用通道。请复制后台真实模型名后重试。
429 Too Many Requests请求过于频繁。请降低并发、增加重试间隔。
500 / 502 / 503上游异常、通道拥堵、模型维护或当前分组没有可用账号。先换同分组其他模型测试；持续出现时请提供模型名称、报错时间和 Request ID。
支付成功但余额未到账先在订单管理确认订单状态。若仍未到账，请提供订单号、支付时间和支付截图；不要提供商户密钥、支付私钥或完整 API Key。

使用规范

  • 不要公开分享 API Key。
  • 不要把 API Key 写进前端网页、公开仓库或群聊。
  • 不要高频并发压测平台。
  • 不要使用平台进行违法违规、攻击、诈骗、垃圾信息等用途。
  • 生产环境建议在服务端转发请求，并设置超时、重试和备用模型。

技术支持

联系管理员时，请尽量提供下面信息，方便快速定位问题：

账号邮箱：
使用的软件：
模型名称：
报错截图：
报错时间：
Request ID：
是否测试过其他模型：
安全提醒：请不要把完整 API Key 发给任何人。需要核对时，只提供前 6 位和后 4 位即可。

前往控制台

© 2026 ATUAI · AI API 统一接入网关 接口地址 https://api.atuai.cn/v1