MoonApiX Docs

Appearance

客户端配置 ​

很多支持 OpenAI-compatible API 的客户端都可以接入 MoonApiX。核心配置通常只有三项：Base URL、API Key 和模型名。

通用配置 ​

配置项值
Base URLhttps://moonapix.com/v1
API Key<MOONAPIX_API_KEY>
Chat 路径/chat/completions
Models 路径/models

如果客户端要求填写完整接口地址，请使用：

text
https://moonapix.com/v1/chat/completions

OpenAI SDK ​

JavaScript:

js
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.MOONAPIX_API_KEY,
  baseURL: 'https://moonapix.com/v1'
})

const response = await client.chat.completions.create({
  model: 'moonapix-chat',
  messages: [{ role: 'user', content: '写一句简短欢迎语。' }]
})

console.log(response.choices[0]?.message?.content)

Python:

python
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["MOONAPIX_API_KEY"],
    base_url="https://moonapix.com/v1",
)

response = client.chat.completions.create(
    model="moonapix-chat",
    messages=[{"role": "user", "content": "写一句简短欢迎语。"}],
)

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

常见客户端 ​

客户端类型配置建议
IDE 助手填写 Base URL、API Key 和模型名。
聊天客户端选择 OpenAI-compatible 类型，Base URL 使用 /v1 结尾。
工作流工具在凭据区保存 API Key，在节点参数里填写模型名。
自研应用使用服务端代理请求 MoonApiX，避免浏览器直接持有密钥。

具体教程：

排查清单 ​

现象检查项
401API Key 是否正确，是否包含 Bearer 前缀。
404Base URL 是否多写或少写 /v1。
模型不可用模型名是否正确，API Key 是否具备该模型权限。
请求超时是否为视频、音乐等异步任务；异步任务需要查询状态。
流式输出异常客户端是否支持 SSE，是否启用了 stream: true。

更多兼容格式见 OpenAI-compatible。