开发者文档

几分钟接入 MogeoLink

准备平台 API Key,并将客户端的 Base URL 设置为 MogeoLink 地址。接口是否可用取决于当前启用的上游渠道与模型。

START HERE

快速开始

所有客户端都需要一个平台 API Key 和 MogeoLink Base URL。

1. 创建 API Key

登录后打开控制台的“令牌管理”,创建 Token,并按需要设置额度和分组。不要把真实密钥提交到代码仓库、截图或公开聊天中。

前往令牌管理 →

2. 设置 Base URL

OpenAI 兼容客户端使用以下地址。站点更换域名后,此处自动使用当前访问域名。

3. 选择已启用模型

在模型广场确认可用模型名、计费类型和价格,然后发起小额测试请求。

OpenAI、Anthropic、Google 和 DeepSeek 的接入方案及参考报价已经整理;渠道 API 密钥仍待管理员填写,当前尚未有可调用模型。
UPSTREAM CHANNELS

配置 OpenAI、Anthropic、Google 与 DeepSeek

真实上游密钥只应由管理员录入渠道后台。先为每个服务商添加渠道,再选择或填入该渠道实际支持的模型并运行测试。

渠道配置步骤

  1. 登录管理员账号,打开渠道管理并新增渠道。
  2. 依次选择 OpenAI、Anthropic、Google(Gemini/Vertex)或 DeepSeek 渠道类型。
  3. 填写渠道名称、上游 API Key 和服务商要求的 Base URL;不要把平台 API Token 当作上游密钥。
  4. 填入默认模型或选择渠道支持的模型,执行测试;通过后再启用渠道。
  5. 在模型计费设置中按对应产品和分组核对费率。前台的“元/$1”是折算参考价,不是每百万 Token 单价。
当前网页展示的费率是参考起始值。模型目录只有在渠道接通并启用后,才会显示实际可用模型;调用前请以控制台中的价格设置为准。
SDK

SDK 接入

OpenAI 官方 SDK 可用于兼容的聊天接口。将示例中的 API Key 和模型名替换为自己的值。

PYTHON · OPENAI SDK

Python 安装:pip install openai。Node.js 安装:npm install openai。

CLIENTS

常见客户端配置

在客户端中选择 OpenAI 兼容提供商,填写以下参数。各客户端版本可能略有差异。

Cursor

模型设置 → OpenAI API Key;填入 API Key 并设置自定义 Base URL。

Cherry Studio

模型服务 → 添加 OpenAI 兼容服务,填写 Base URL、API Key 和模型 ID。

Chatbox

模型提供商 → OpenAI API,开启自定义接口地址。

Continue / Cline

选择 OpenAI Compatible,并配置 Base URL、API Key 和已启用模型名。

CONFIGURATION
{
  "baseURL": "",
  "apiKey": "YOUR_MOGEOLINK_API_KEY",
  "model": "YOUR_ENABLED_MODEL"
}
ANTHROPIC

Anthropic Messages 兼容

如当前渠道已配置 Anthropic 兼容路由,可使用 Messages API。请求头与模型可用情况应以渠道配置为准。

BASH
curl /messages \
  -H "x-api-key: $MOGEOLINK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"YOUR_ENABLED_MODEL","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'
不要混用不同协议的请求路径、认证头和请求参数。只有已配置相应上游路由时,该接口才会成功。
REFERENCE

常用接口

支持范围由 MogeoLink 当前部署版本和已接入上游决定。

GET /v1/models

读取平台公开的模型列表(须有已启用模型)。

POST /v1/chat/completions

OpenAI 兼容聊天补全。

POST /v1/responses

OpenAI Responses API 兼容入口。

POST /v1/messages

Anthropic Messages 兼容入口。

POST /v1/images/generations

图像生成,取决于已配置图像模型。

POST /v1/audio/speech

语音生成,取决于对应模型与渠道。

POST /v1/embeddings

文本向量化,取决于对应上游能力。

POST /v1/rerank

重排序,取决于对应模型与渠道。

查看 API 参考页面