快速开始

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。

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 里使用 Mo API，请先完成账号、余额、API Key 和 auth.json 配置，然后把 Mo API 作为 Codex 的模型提供方写入用户级配置。

前置条件

创建 Codex API Key

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

添加 auth.json

如果还没有登录 Codex，才需要把获取到的 auth.json 放到 Codex 用户级目录：

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

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

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

写入 config.toml

打开 Codex 用户级配置文件 ~/.codex/config.toml。如果文件不存在，可以手动新建。 建议把下面这段配置放在文件顶部，并把示例 Key 替换成你真实创建的 API Key。

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

[model_providers.moapi]
name = "moapi"
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 已经接入成功。

API Reference

错误码

More

常见问题

现在支持哪些模型？

目前只有 GPT 系列，推荐使用 gpt-5.5。后续新增模型时可以在模型页继续扩展。

是否兼容 OpenAI SDK？

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

API Key 应该放在哪里？

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

Resources

资源推荐