Manaforge API 文档

API Key 使用与自助检查

这里是 Manaforge API 的客户文档页。你可以查看 Base URL、调用示例,并输入自己的 API Key 检查是否可用。 后续这里会接入用量查询和 Key 重置功能。

1. API 基本信息

Base URL:

https://api.manaforge.xyz/v1

请求头:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
请不要把 API Key 上传到公开代码仓库,也不要写在浏览器前端代码里。

2. 检查你的 API Key

输入你的 API Key,系统会请求 /v1/models 来检查 Key 是否可用。

等待检查...

3. 查询用量与重置 Key

这两个功能需要接入 Manaforge 的客户安全后端,不能直接在网页前端调用管理员接口。 当前页面先保留入口,防止把后台管理员权限暴露给客户。

当前版本:Key 有效性检查已可用;用量查询和重置 Key 等待后端接入。
如果你怀疑 API Key 泄露,请立即联系 support@manaforge.xyz。 管理员会帮你禁用旧 Key 并重新生成。

4. curl 示例

查询模型

curl https://api.manaforge.xyz/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

聊天请求

curl https://api.manaforge.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "your-model",
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'

5. Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.manaforge.xyz/v1"
)

resp = client.chat.completions.create(
    model="your-model",
    messages=[
        {"role": "user", "content": "Hello Manaforge"}
    ]
)

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

6. Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.manaforge.xyz/v1"
});

const resp = await client.chat.completions.create({
  model: "your-model",
  messages: [
    { role: "user", content: "Hello Manaforge" }
  ]
});

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

7. 常见错误

  • 401 / 403: API Key 错误、过期、被禁用或无权限。
  • 404: 请求路径错误,例如直接访问 /v1 可能会 404。
  • 429: 请求过快、并发过高或额度不足。
  • 500 / 502: 服务端或上游暂时异常,请稍后重试。