猫猫的AI中转站Logo 猫猫的AI中转站 DOCS CENTER
控制台
AIMAO TODAY · API DOCS

猫猫的AI中转站文档中心

01
COMMUNITY · 官方通知

Telegram 群组通知

建议用户加入群组，第一时间获取平台动态与维护公告。

加入 猫猫的AI中转站 官方 Telegram 群组

群组内会同步平台公告、模型维护、优惠活动与技术解答。

加入 Telegram 群组
02
GET STARTED · 核心指南

快速接入与接口地址

按照标准端点规范，只需两步即可完成全链路配置。

1. 创建 API Key

登录 猫猫的AI中转站控制台，在侧边栏进入「API 密钥」，创建并复制您的密钥（sk-...）。

2. 填写接口地址

在客户端选择 OpenAI 兼容接口，Base URL 填写猫猫的AI中转站对应端点地址。

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

base-url 
https://api.aimao.today/v1

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

auto-prefix 
https://api.aimao.today

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

full-path 
https://api.aimao.today/v1/chat/completions
i

注意：不同软件对 Base URL 的拼接方式不同。如果请求失败，可以在 https://api.aimao.today 和 https://api.aimao.today/v1 之间切换测试。

首次连通性测试

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

curl / models 
curl https://api.aimao.today/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

通过 CCS / CC Switch 一键接入

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

01 进入 API 密钥

登录猫猫的AI中转站控制台，在侧边栏点击「API 密钥」。

02 创建密钥

点击右上角「创建密钥」，选择可用分组后生成 API Key。

03 导入到 CCS

在密钥列表右侧操作栏点击「导入到 CCS」，即可导入 CC Switch 使用。

i

CC Switch 可用于管理 Claude Code、Codex、Gemini CLI 等客户端配置。具体可用模型和分组以猫猫的AI中转站控制台显示为准。

下载 CC Switch ↓ 请仅从官方 GitHub Releases 获取客户端，避免使用来源不明的安装包。
首次调用前核对
  • API Key 已创建且处于启用状态。
  • 模型名称从控制台完整复制。
  • Base URL 是否由客户端自动补全 /v1。
  • 先发送一条短文本，确认返回正常后再开启流式或高并发调用。
03
CLIENT · 客户端配置

Cherry Studio 配置

桌面端多模型全能助手接入。

  1. 打开模型服务设置打开 Cherry Studio，点击左下角「设置」 -> 「模型服务」。
  2. 选择 OpenAI 提供商在左侧列表中选择「OpenAI」（或新建自定义供应商）。
  3. 填写 API 地址与密钥API 地址填 https://api.aimao.today/v1，密钥填入 sk-...。
  4. 添加所需模型添加您需要调用的模型 ID，保存即可直接对话。
04
CLIENT · 代码编辑器

Cursor / VS Code 配置

进入 Cursor Settings -> Models -> OpenAI API Key 进行配置：

  1. 开启覆写接口地址 开启 Override OpenAI Base URL 开关。
  2. 填写 Base URL 输入接口地址：https://api.aimao.today/v1
  3. 填入密钥与模型 填入您的 API Key（sk-...），并在 Model 列表中添加对应的模型名称即可。
05
CLIENT · 终端助手

Claude Code / Cline 配置

支持原生 Anthropic /v1/messages 调度协议。

bash / env 
# 环境变量配置
export ANTHROPIC_BASE_URL="https://api.aimao.today"
export ANTHROPIC_API_KEY="sk-您的APIKey"

# 启动 Claude Code
claude
06
CLIENT · CODEX

Codex CLI 配置

修改本地 config.toml 与 auth.json 即可直连。

config.toml 
[model_providers.aimao]
name = "aimao"
base_url = "https://api.aimao.today"
wire_api = "responses"
requires_openai_auth = true
07
DEVELOPER · 代码调用

代码调用示例

兼容所有官方 OpenAI SDK。

Python (OpenAI SDK)

python 
from openai import OpenAI

client = OpenAI(
    api_key="sk-您的APIKey",
    base_url="https://api.aimao.today/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
08
ERRORS · 故障排查

常见错误

排查请求失败的 7 种核心状态。

401 Unauthorized

API Key 错误、缺失或已被删除。检查请求头是否包含 Authorization: Bearer YOUR_API_KEY。

403 INSUFFICIENT_BALANCE

账户余额不足。请充值，或切换低倍率模型。

403 Access Denied

访问策略、地区策略、账号状态或风控限制。请检查网络环境和平台公告。

404 / 503 model_not_found

模型名称错误，或当前分组没有该模型可用通道。请复制后台真实模型名后重试。

429 Too Many Requests

请求过于频繁。请降低并发、增加重试间隔。

500 / 502 / 503

上游异常、通道拥堵、模型维护或当前分组没有可用账号。先换同分组其他模型测试；持续出现时请提供模型名称、报错时间和 Request ID，便于管理员检查上游账号和模型映射。

支付成功但余额未到账

先在订单管理确认订单状态。若支付完成后仍未到账，请提供订单号、支付时间和支付截图；不要提供商户密钥、支付私钥或完整 API Key。

09
SUPPORT · 客服支持

技术支持

遇到问题随时联系我们的社群与人工客服。

如在使用过程中遇到任何接口连通性问题或需要人工协助，请随时联系官方客服：

👉 Telegram 官方社群：https://t.me/aimao_today

已复制到剪贴板