文档快速开始站内基础教程
官方 SDK 支持
使用 OpenAI 兼容 SDK 快速接入 MoleAPI
MoleAPI 兼容主流 OpenAI 风格 SDK。通常只需要替换两项：
apiKeybaseURL
什么时候适合直接用 SDK
如果你符合下面任一场景，通常就应该优先用官方 SDK，而不是自己手拼 HTTP 请求：
- 你已经在用 Python / Node.js 开发业务
- 你后面还会接流式输出、图片、音频或工具调用
- 你希望少处理底层请求细节，先把功能跑通
一个简单判断
如果你只是想验证账号可用，先用 cURL；如果你准备把能力接进项目，优先直接上 SDK。
Python 示例
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["MOLEAPI_KEY"],
base_url="https://api.moleapi.com/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用一句话说明 SDK 接入要点"}],
)
print(resp.choices[0].message.content)如果你还没有设置环境变量，可以先在当前终端执行：
$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"Node.js 示例
import OpenAI from "openai";
async function main() {
const client = new OpenAI({
apiKey: process.env.MOLEAPI_KEY,
baseURL: "https://api.moleapi.com/v1",
});
const res = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Hello MoleAPI" }],
});
console.log(res.choices[0]?.message?.content);
}
main().catch(console.error);Node.js 里同样建议通过环境变量读取 Key，而不是把真实密钥写进源码或提交到仓库。
最常见的兼容性问题
baseURL写成了别的平台地址，或漏掉/v1- 环境变量没注入成功，导致请求时实际拿到的是空值
- 复制示例时顺手带上了不兼容的模型名或参数
- 本地能通，但部署环境没有同步相同的 Key 和 Base URL
推荐的接入顺序
- 先用最短示例跑通一次
- 再替换成你业务真实要用的模型
- 最后再接流式输出、重试、超时和日志
这样定位问题最简单，因为你能清楚知道是“平台接入没通”，还是“业务复杂逻辑引入了新问题”。
常见排错
- 报 401：先检查 API Key 和环境变量
- 报 404：优先检查
baseURL是否包含/v1 - 报模型不可用：检查分组和模型权限
下一步建议看什么
这篇文档对您有帮助吗？
最后更新于