开发者快速接入

如果你准备自己写代码接入 MoleAPI，先记住这两项：

Base URL：https://api.moleapi.com/v1
认证方式：Authorization: Bearer <YOUR_API_KEY>

最常见的第一个接口是：

POST /chat/completions

第 0 步：先把两个参数放到环境里

推荐不要把 API Key 直接写死在代码里，而是先放到环境变量。

PowerShell

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Bash / zsh

export MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

为什么先用环境变量

这样你在切换本地测试、CI 和正式环境时，只需要替换环境配置，不用反复改源码。

cURL 示例

Bash / zsh

curl https://api.moleapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MOLEAPI_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍 MoleAPI。"}
    ]
  }'

PowerShell

$headers = @{
  "Content-Type" = "application/json"
  "Authorization" = "Bearer $env:MOLEAPI_KEY"
}

$body = @{
  model = "gpt-4o-mini"
  messages = @(
    @{
      role = "user"
      content = "你好，请用一句话介绍 MoleAPI。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://api.moleapi.com/v1/chat/completions" `
  -Headers $headers `
  -Body $body

如果请求成功，你通常会拿到一个 JSON 响应，里面至少会包含：

id
model
choices[0].message.content

你只要能看到模型正常返回文本，就说明最小接入链路已经跑通了。

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": "你好，请返回一句接入成功提示。"}],
)

print(resp.choices[0].message.content)

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 resp = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好，请返回一句接入成功提示。" }],
  });

  console.log(resp.choices[0]?.message?.content);
}

main().catch(console.error);

第一次跑通时，建议只验证这 3 件事

请求能收到正常 JSON 响应
返回内容不是报错信息
你使用的模型名和分组是当前可用的

等这一步稳定后，再逐步加上：

流式输出
更长上下文
工具调用
图片、音频等多模态能力

最小排错顺序

先确认 Base URL 和路径正确
再确认 API Key 有效，且有目标模型权限
最后核对模型名和当前分组

建议先小后大

先用最短请求跑通，再逐步加入长上下文、流式输出和更复杂参数。

如果 cURL 能通，但你的项目代码不通

这通常说明平台本身没问题，更可能卡在项目接入层。优先检查：

代码里是否真的读取到了 MOLEAPI_KEY
SDK 配置里 baseURL / base_url 是否仍指向其他平台
业务代码有没有对请求地址做二次拼接
代理、网关或服务端环境变量是否和本地不一致

下一步建议看什么

除了传统的 OpenAI chat/completions 接口外，MoleAPI 的部分模型还支持 OpenAI 最新的 responses 接口、Gemini 接口，以及 Anthropic 的请求接口。具体支持情况和调用方式可以前往 API 参考查看。

本页目录