MMojika API

Mojika API 接入文档

请选择你的使用方式

跟着向导一步一步做

页面会记住你做到哪一步,但不会保存 API Key。

可点击步骤编号切换内容
STEP 1 / 5

安装电脑端 ChatGPT

    ↗
    ✓

    第 1 步,共 5 步
    开发者 5 分钟调用使用 cURL、Python 或 Node.js 发起第一条请求 Codex / OpenAI 客户端查看 Responses API 和 OpenAI 兼容配置 Claude Code查看 Anthropic Messages 兼容配置

    完整参考目录

    一个 Mojika API Key,可用于模型广场中当前账号有权限访问的模型。模型、分组和价格以控制台实时显示为准。

    一、先认识 3 个概念

    1. API Key

    API Key 相当于调用 Mojika API 的访问凭证,通常以 sk- 开头。实际使用时,请替换成你在控制台创建的真实密钥。

    不要把真实 API Key 发到群聊、截图、公开仓库、浏览器前端代码或第三方表单中。

    2. Base URL

    Base URL 是客户端连接 Mojika API 的基础地址。不同工具的填写方式不同,最容易出错的是是否需要携带 /v1。

    3. 模型名称

    模型名称必须从 Mojika API 的模型广场复制,完整保留大小写、数字和连字符,不要凭记忆填写。

    二、开发者 5 分钟 API 调用

    1. 打开 Mojika API 控制台并登录。
    2. 进入 API 密钥页面创建密钥。
    3. 从模型广场复制当前分组可用的模型名称。
    4. 先调用模型列表,再发送第一条对话请求。

    查询当前 Key 可见的模型

    GEThttps://mojika.space/v1/models
    cURL
    curl -fsS "https://mojika.space/v1/models" \
      -H "Authorization: Bearer $MOJIKA_API_KEY"

    发送第一条对话请求

    POSThttps://mojika.space/v1/chat/completions
    cURL
    curl -X POST "https://mojika.space/v1/chat/completions" \
      -H "Authorization: Bearer $MOJIKA_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "从模型广场复制模型名称",
        "messages": [
          {"role": "user", "content": "你好,请用一句话介绍你自己。"}
        ]
      }'

    三、接口和 Base URL 怎么选

    使用场景协议填写地址
    OpenAI 兼容客户端Chat Completionshttps://mojika.space/v1
    Codex / ResponsesOpenAI Responseshttps://mojika.space/v1
    Claude CodeAnthropic Messageshttps://mojika.space
    CC Switch 导入由 CCS 补路径https://mojika.space
    最终请求地址中通常只能出现一次 /v1,不要写成 /v1/v1/...。如果当前客户端明确要求完整路径,再填写带 /v1 的地址。

    四、手动配置 Codex CLI(高级)

    如果你需要手动管理 Codex CLI 的 provider,可以在配置文件中声明 Mojika API。Codex 使用 Responses API 时填写带 /v1 的地址,并确认所选模型支持该接口。

    配置文件

    config.toml
    model = "你的模型名称"
    model_provider = "mojika"
    
    [model_providers.mojika]
    name = "Mojika API"
    base_url = "https://mojika.space/v1"
    env_key = "MOJIKA_API_KEY"
    wire_api = "responses"
    requires_openai_auth = false

    设置 API Key

    Windows PowerShell
    $env:MOJIKA_API_KEY="sk-你的API密钥"
    codex
    macOS / Linux
    export MOJIKA_API_KEY="sk-你的API密钥"
    codex
    高级配置改动前建议备份原配置。出现 401 时先检查环境变量是否在当前终端生效,出现 404 时检查是否重复添加了 /v1。
    如果请求提示模型不存在,请核对模型广场中的完整 ID,以及 API Key 是否有权访问该模型分组。

    五、接入 Claude Code

    Claude Code 使用 Anthropic Messages 兼容协议,Base URL 按根地址填写,不要主动添加 /v1。

    Windows PowerShell
    $env:ANTHROPIC_BASE_URL="https://mojika.space"
    $env:ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"
    $env:ANTHROPIC_MODEL="你的模型名称"
    $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
    claude
    macOS / Linux
    export ANTHROPIC_BASE_URL="https://mojika.space"
    export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"
    export ANTHROPIC_MODEL="你的模型名称"
    export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
    claude

    六、接入 CC Switch

    推荐优先使用 Mojika API 控制台中的一键导入功能;如果当前页面没有导入按钮,可以按下面方式手动添加供应商。

    1. 打开 CC Switch 官方发布页。
    2. 下载 Windows 安装包并完成安装。
    3. 打开 CC Switch,新增自定义供应商,Provider 名称填写 Mojika API。
    4. Base URL 填写 https://mojika.space,API Key 填入控制台创建的密钥。
    5. 点击“获取上游模型”,选择可用模型后保存并启用。
    下载 Windows 版 CC Switch↗
    CC Switch 导入模式可能会自动补充 /v1;如果你在客户端中手动填写完整 OpenAI 地址,则使用 https://mojika.space/v1,不要重复添加路径。

    七、接入 OpenCode

    OpenCode 使用 OpenAI 兼容协议时,填写 Mojika API 的带 /v1 地址,并将模型名称替换为模型广场中的完整 ID。

    opencode.json
    {
      "provider": {
        "mojika": {
          "name": "Mojika API",
          "baseURL": "https://mojika.space/v1",
          "apiKey": "${MOJIKA_API_KEY}",
          "model": "从模型广场复制的模型名称"
        }
      }
    }

    保存后重新打开 OpenCode,并用一条短消息测试模型是否能正常返回内容。

    八、接入 OpenClaw

    OpenClaw 的自定义 provider 需要填写服务地址、密钥和模型。字段名称可能随版本变化,请以当前版本的设置页面为准。

    配置项填写内容说明
    Provider NameMojika API用于在客户端中识别供应商。
    Base URLhttps://mojika.space/v1OpenAI 兼容模式使用带 /v1 的地址。
    API Keysk-你的API密钥不要把密钥写入公开配置。
    Model模型广场中的模型 ID完整复制模型名称。

    九、接入 Hermes Agent

    Hermes Agent 可以通过 OpenAI 兼容环境变量接入。使用前请先在模型广场确认模型支持当前接口类型。

    macOS / Linux
    export OPENAI_API_KEY="sk-你的API密钥"
    export OPENAI_BASE_URL="https://mojika.space/v1"
    export OPENAI_MODEL="你的模型名称"
    hermes
    如果 Hermes Agent 要求完整的 chat completions 地址,请使用 https://mojika.space/v1/chat/completions,不要再额外拼接一次路径。

    十、接入 Cherry Studio

    在 Cherry Studio 中新增 OpenAI Compatible 服务商,按以下内容填写:

    字段填写内容备注
    名称Mojika API自定义显示名称。
    API 地址https://mojika.space/v1不要重复填写 /v1。
    API Keysk-你的API密钥从控制台复制。
    模型模型广场中的模型 ID可点击获取模型,也可手动添加。

    十一、接入 Cline

    在 Cline 的 API Provider 中选择 OpenAI Compatible,填写 Mojika API 的接口地址和密钥。

    1. 打开 Cline 设置,选择 OpenAI Compatible。
    2. Base URL 填写 https://mojika.space/v1。
    3. API Key 填写控制台创建的密钥。
    4. Model ID 填写模型广场中可用的完整模型名称。
    如果 Cline 连接失败,请关闭“自定义 OpenAI Endpoint”中重复的路径拼接选项,再重新测试。

    十二、其他 OpenAI Compatible 客户端

    在 ChatGPT、Cherry Studio、Cline、OpenCode 或其他兼容客户端中,按下面三项配置:

    配置项填写内容说明
    ProviderMojika API自定义名称即可。
    Base URLhttps://mojika.space/v1OpenAI 兼容客户端使用带 /v1 的地址。
    API Keysk-你的API密钥使用控制台创建的密钥。
    Model模型广场中的模型 ID必须完整匹配。

    十三、Python 示例

    Python
    from openai import OpenAI
    
    client = OpenAI(
        api_key="YOUR_MOJIKA_API_KEY",
        base_url="https://mojika.space/v1",
    )
    
    result = client.chat.completions.create(
        model="你的模型名称",
        messages=[{"role": "user", "content": "你好,Mojika API!"}],
    )
    
    print(result.choices[0].message.content)

    十四、Node.js 示例

    Node.js
    import OpenAI from "openai";
    
    const client = new OpenAI({
      apiKey: process.env.MOJIKA_API_KEY,
      baseURL: "https://mojika.space/v1",
    });
    
    const response = await client.chat.completions.create({
      model: "你的模型名称",
      messages: [{ role: "user", content: "你好,Mojika API!" }],
    });
    
    console.log(response.choices[0].message.content);

    十五、常见问题

    问题常见原因处理方式
    401 UnauthorizedKey 错误、被撤销或没有读取到环境变量重新复制 Key,确认请求头和当前终端变量。
    404 Not FoundBase URL 或接口路径重复检查是否写成了 /v1/v1,并确认使用了正确协议。
    模型不存在模型 ID 拼写错误或分组无权限从模型广场复制当前 Key 可见的完整模型名称。
    429 Too Many Requests并发、频率或余额限制降低请求频率,并检查账户余额和使用记录。

    十六、API Key 安全提醒

    不要公开不要发到群聊、截图、GitHub 或前端代码。
    分开使用不同设备或项目建议创建不同的 Key。
    及时撤销发现泄露后立即撤销并重新创建。

    十七、一页速查

    使用方式Base URL关键设置
    CC Switch 导入https://mojika.space让 CC Switch 自动补 /v1。
    OpenAI / Codexhttps://mojika.space/v1Responses 或 Chat Completions。
    Claude Codehttps://mojika.spaceAnthropic Messages 兼容协议。
    模型模型广场复制不要手动猜模型名称。