快速开始

Mo API 文档

Mo API 目前提供 GPT 系列模型，推荐使用 GPT 5.5，并采用 OpenAI 兼容接口格式。你可以用同一个 Base URL、API Key 和模型名接入命令行工具、业务后端或 AI 编程工具。

1. 创建 API Key

打开 Mo API 控制台，注册或登录账号后创建一个可用于调用接口的密钥。密钥通常只在创建后完整展示一次，请及时保存到安全的位置。

2. 发起第一次请求

下面的示例会调用 GPT 5.5 生成一个简短回复。

curl https://api.moshushi.xyz/v1/chat/completions \
  -H "Authorization: Bearer $MOSHUSHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

3. 继续接入

如果你的工具支持 OpenAI 兼容服务，只需要把 Base URL 改成 https://api.moshushi.xyz/v1，模型名推荐填写 gpt-5.5，也可以使用 gpt-5.4。

API Reference

认证

所有 API 请求都需要在请求头中传入 Bearer Token。

Authorization: Bearer YOUR_API_KEY

不要把 API Key 暴露在前端网页、公开仓库、移动端明文包或客户端日志中。生产环境建议通过后端代理调用。

API Reference

模型

目前提供 GPT 系列模型，推荐优先使用 gpt-5.5：

列出模型

curl https://api.moshushi.xyz/v1/models \
  -H "Authorization: Bearer $MOSHUSHI_API_KEY"

API Reference

Chat Completions

创建一次多轮对话补全。请求格式与 OpenAI Chat Completions 兼容。

请求参数

JavaScript 示例

const response = await fetch("https://api.moshushi.xyz/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.MOSHUSHI_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-5.5",
    messages: [
      { role: "system", content: "你是一个简洁可靠的助手。" },
      { role: "user", content: "帮我写一个接口测试清单。" }
    ],
    temperature: 0.7
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

响应格式

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1780675200,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "这是模型返回的内容。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 12,
    "total_tokens": 30
  }
}

API Reference

流式输出

将 stream 设置为 true 后，接口会以 Server-Sent Events 的形式逐段返回内容，适合聊天窗口、代码生成和长文本输出。

curl https://api.moshushi.xyz/v1/chat/completions \
  -H "Authorization: Bearer $MOSHUSHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      { "role": "user", "content": "写一段 100 字以内的产品说明" }
    ]
  }'

Guides

工具接入

大多数 OpenAI 兼容客户端只需要配置三个值：

如果工具要求填写完整接口地址，请使用 https://api.moshushi.xyz/v1/chat/completions。

Guides

Codex 接入

Codex 支持通过 config.toml 配置第三方模型提供方。接入 Mo API 时， 可以优先使用环境变量保存 API Key，也可以把 API Key 直接写入配置文件。

前置条件

1创建 Codex API Key

登录 Mo API 控制台后，进入左侧的 API 密钥 页面创建新密钥。创建时名称可以填写 codex，分组请选择 codex-plus。不要选择测试分组。

2添加 auth.json（可选）

auth.json 是 Codex 的登录凭据文件。它通常包含登录令牌、刷新会话所需的信息和账户标识， Codex 启动时会读取它来确认客户端已经完成登录。

如果需要使用 Codex 账号登录状态，请把获取到的 auth.json 放到 Codex 用户级目录：

等价写法：%USERPROFILE%\.codex\auth.json

# Windows
C:\Users\你的用户名\.codex\auth.json

# macOS / Linux
~/.codex/auth.json

不要手动修改或公开分享 auth.json，其中的登录凭据应当像密码一样保管。

方式一：使用环境变量（优先选择）

Windows PowerShell 设置用户级环境变量：

[Environment]::SetEnvironmentVariable("MOAPI_API_KEY", "sk-替换成你的key", "User")

macOS / Linux 添加到 ~/.zshrc：

echo 'export MOAPI_API_KEY="sk-替换成你的key"' >> ~/.zshrc
source ~/.zshrc

打开 Codex 用户级配置文件 ~/.codex/config.toml。如果文件不存在，可以手动新建。 把下面这段配置放在文件顶部：

model_reasoning_effort = "medium"
model = "gpt-5.5"
model_provider = "moapi"

[model_providers.moapi]
name = "Mo API"
wire_api = "responses"
base_url = "https://api.moshushi.xyz/v1"
env_key = "MOAPI_API_KEY"

方式二：直接写入 config.toml

如果不想设置环境变量，也可以把 API Key 直接写进 config.toml。 这种方式配置更直接，但密钥会以明文保存在本地文件中。

model_reasoning_effort = "medium"
model = "gpt-5.5"
model_provider = "moapi"

[model_providers.moapi]
name = "Mo API"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.moshushi.xyz/v1"
experimental_bearer_token = "sk-替换成你的key"

重启并测试

保存 config.toml 后，关闭并重新打开 Codex。重启后发送一个简单任务，例如 帮我写一个 hello world，如果能正常回复，说明 Mo API 已经接入成功。

Guides

Claude Code 接入

在 Claude Code 中使用 Mo API，可以通过 CC-Switch 一键导入，也可以手动配置环境变量或配置文件。

方法一：CC-Switch 一键导入

在 Mo API 控制台的「令牌」页面，点击令牌操作菜单中的「CC-Switch」，选择 Claude 模式， 一键将配置导入 Claude Code。

方法二：手动配置环境变量

在终端中设置以下环境变量，并把示例 Key 替换成你的真实 API Key：

export ANTHROPIC_BASE_URL=https://api.moshushi.xyz
export ANTHROPIC_AUTH_TOKEN=sk-your-key

macOS / Linux

添加到 ~/.bashrc 或 ~/.zshrc：

echo 'export ANTHROPIC_BASE_URL=https://api.moshushi.xyz' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.moshushi.xyz", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-your-key", "User")

方法三：配置文件

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moshushi.xyz",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

指定模型

export ANTHROPIC_MODEL=claude-sonnet-4-6

可选模型：claude-opus-4-7、claude-opus-4-6、 claude-sonnet-4-6、claude-haiku-4-5-20251001。

API Reference

错误码

More

常见问题

现在支持哪些模型？

目前支持 OpenAI、Anthropic 和 xAI 的主流模型，包括 GPT、Claude 和 Grok 系列。 具体可用模型、模型名称和价格请前往 模型广场查看。

是否兼容 OpenAI SDK？

兼容 OpenAI 风格的 Chat Completions 调用。把 Base URL 设置为 https://api.moshushi.xyz/v1，模型设置为 gpt-5.5。

API Key 应该放在哪里？

建议放在服务端环境变量，例如 MOSHUSHI_API_KEY。不要在浏览器前端直接暴露密钥。

Resources

资源推荐