小喵AI 帮助文档

开始使用

小喵AI 当前主要提供 GPT API 调用服务。你可以把它理解成一个 OpenAI 兼容接口：支持在客户端、插件或代码中填写自定义 API 地址进行调用。

接入地址

大部分软件会要求填写 API 地址，也可能叫接口地址、Base URL、代理地址或自定义接口地址。

获取 API Key

API Key 是你的调用凭证，请不要公开分享给其他人。

1. 打开 小喵AI 并登录。
2. 进入控制台。
3. 找到 API Key、令牌或密钥管理页面。
4. 点击创建新的 API Key。
5. 复制生成的 Key，并保存到你的客户端或代码环境中。

常用客户端配置

Codex CLI

Codex CLI 适合在终端、Cursor、VSCode 等开发环境中使用。配置时需要分别准备 config.toml 和 auth.json 两个文件。

macOS / Linux 配置路径

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.xmdo.top"
wire_api = "responses"
requires_openai_auth = true

然后在 ~/.codex/auth.json 中填写：

{
  "OPENAI_API_KEY": "sk-你的真实API-Key"
}

Windows 配置路径

Windows 下的文件内容和 macOS / Linux 相同，只是存放路径不同。

OpenCode

OpenCode 可以通过配置文件接入小喵AI。配置文件通常位于 ~/.config/opencode/opencode.json，也可以使用项目内的 opencode.json。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.xmdo.top/v1",
        "apiKey": "sk-你的真实API-Key"
      },
      "models": {
        "gpt-5.2": {
          "name": "GPT-5.2",
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        },
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": {
            "context": 1050000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        },
        "codex-mini-latest": {
          "name": "Codex Mini",
          "limit": {
            "context": 200000,
            "output": 100000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {}
          }
        }
      }
    }
  },
  "agent": {
    "build": {
      "options": {
        "store": false
      }
    },
    "plan": {
      "options": {
        "store": false
      }
    }
  }
}

Cherry Studio

适合在桌面端统一管理多个 GPT 对话模型。

NextChat / LobeChat

适合网页端或自部署聊天界面。

沉浸式翻译

适合浏览网页时使用 GPT 做翻译。

Cursor / VSCode 插件

如果插件支持 OpenAI 兼容接口，一般填写下面两项：

开发者调用示例

小喵AI兼容 OpenAI 风格接口。你可以在官方 SDK 中指定 base_url 或 baseURL。

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://api.xmdo.top/v1"
)

response = client.chat.completions.create(
    model="后台可用模型名称",
    messages=[
        {"role": "user", "content": "你好，介绍一下小喵AI"}
    ]
)

print(response.choices[0].message.content)

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的 API Key",
  baseURL: "https://api.xmdo.top/v1"
});

const response = await client.chat.completions.create({
  model: "后台可用模型名称",
  messages: [
    { role: "user", content: "你好，介绍一下小喵AI" }
  ]
});

console.log(response.choices[0].message.content);

订阅说明

小喵AI当前以订阅套餐为主。不同套餐的可用额度、有效期和权限可能不同， 具体内容以购买页面展示为准。

模型说明

小喵AI当前主要提供 GPT 相关模型能力。不同账号、套餐或分组可用的模型可能不同。

常见问题

1. Base URL 到底填哪个？

优先填写 https://api.xmdo.top/v1。 如果客户端会自动拼接 /v1，就填写 https://api.xmdo.top。

2. API Key 填了还是不能用？

请检查这几项：

• Key 是否复制完整。
• Key 前后是否多了空格。
• 当前账号是否已经开通订阅。
• 客户端是否保存了旧配置，需要重启。

3. 为什么提示模型不存在？

通常是模型名称填写不正确。请从小喵AI后台或客户端模型列表中复制可用模型名称。

4. 为什么有的软件必须填写完整地址？

不同软件的请求方式不同。有的软件要填写 Base URL， 有的软件要填写完整的聊天接口地址。 如果文档中单独标明了 /v1/chat/completions， 就按该软件要求填写完整地址。

5. 订阅后没有立即生效怎么办？

先刷新页面或重新登录。如果仍然没有生效，请保留账号信息和订单信息，联系管理员核查。