快速开始

欢迎来到 MoleAPI。

如果你现在的目标只有一个——尽快把接口跑通，那么这篇文档就是给你准备的。你不需要先把所有文档看完，只要按下面 3 步走，通常就能完成第一次可用接入。

第一步：创建你的 API Key

在使用 MoleAPI 前，你需要先创建一个 API Key（也叫 令牌）。

它的作用很简单：

• 用来标识你的调用身份
• 控制你能访问哪些模型
• 记录日志与费用归属

你可以在控制台里完成创建：

• 入口地址：https://home.moleapi.com/console/token
• 页面路径：控制台 → KEY 管理

创建页面的实际界面如下：

如果你只是第一次测试，推荐先这样填：

• 名称：dev-local
• 分组：默认分组
• 过期时间：一个月
• 数量：1
• 模型限制：先不限制
• IP 白名单：先留空

如果你想逐字段理解这张图，可以继续看：

• 创建 API Key（带字段讲解）
• API Key 是什么

第二步：准备两个核心接入参数

大多数支持 OpenAI 兼容接口的客户端、SDK 或自建项目，只需要下面两个核心参数就能开始使用：

你可以这样理解：

• Base URL 决定请求发到哪里
• API Key 决定你是谁、有没有权限、这次费用记到哪里

为什么 Base URL 通常要填到 /v1

因为很多工具会自动在你填写的地址后继续拼接接口路径，比如：

• /chat/completions
• /responses
• /embeddings

所以如果你不确定怎么填，优先使用：

https://api.moleapi.com/v1

如果你想深入理解这个问题，可以看：

• Base URL 怎么填

第三步：粘贴到你的 AI 应用或代码中

当你已经拿到：

• Base URL
• API Key

接下来就可以把它们粘贴到任意支持 OpenAI 兼容接口的工具中使用，例如：

• Chatbox
• NextChat
• Cherry Studio
• 沉浸式翻译
• 自己写的 OpenAI SDK 代码

通常只要把这两个值填对，就已经能开始正常调用。

在 AI 应用中通常还需要选择模型才能使用。请注意：

• 模型只能从 MoleAPI 定价页 中提供的列表里选择。
• 若你的令牌设置了分组，则只能选择该分组内可用的模型。
• 具体可用模型与定价说明见：支持模型与定价。

如果你还不确定自己的账号、分组和模型配置是不是都正常，建议先去站内聊通一轮，再开始接第三方客户端或代码：

• 聊天页面
• 支持模型页面

如果你现在还是跑不通，优先检查这 4 件事

1. Base URL 是否写成了 https://api.moleapi.com/v1
2. API Key 是否真的是 MoleAPI 控制台创建的 sk-...
3. 模型名是否填写正确
4. 当前 Key 所在分组是否支持该模型

很多新手的第一类问题，基本都卡在这里。

接下来有两条继续接入的路线

你不用把所有文档一次看完，按自己的目标继续就够了：

• 想接现成 AI 应用：先看 AI 应用文档，按对应客户端的配置页填写 Base URL 和 API Key
• 想自己写代码接入：先看 开发者快速接入，用最小请求先把调用跑通

接下来建议看什么？

如果你已经跑通第一次调用，下一步建议按你的目标继续：