快速开始

从零到第一次成功的对话补全，大约 3 分钟。

第 1 步：注册并登录

1. 浏览器打开 ai.moespark.dev。
2. 点击「注册」，用邮箱设置用户名与密码（密码建议 8 位以上含字母和数字）。
3. 登录后进入控制台首页，可看到可用模型、余额与公告。

第 2 步：创建令牌（API Key）

1. 左侧菜单进入「令牌」页面。
2. 点击「添加令牌」，填写：
   • 名称：便于识别的用途，如 my-app。
   • 额度：可设为「无限额度」或指定金额/次数。
   • 过期时间：按需设置，留空表示长期有效。
   • 可用模型 / 分组：默认继承用户分组，可按需限制。
3. 保存后复制生成的密钥（形如 sk-xxxxxxxxxxxxxxxx）。密钥只完整显示一次，请妥善保存。

第 3 步：发起第一次调用

把下面示例里的 sk-你的令牌 替换掉即可。

curl https://ai.moespark.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手。"},
      {"role": "user", "content": "用一句话解释什么是 API 网关。"}
    ],
    "temperature": 0.7
  }'

成功时返回 JSON，正文在 choices[0].message.content：

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "created": 1794370000,
  "model": "gpt-4o-mini",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "API 网关是……"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 28, "completion_tokens": 42, "total_tokens": 70}
}

用官方 SDK（推荐）

任何 OpenAI SDK 只要改 base_url 就能用：

# Python
from openai import OpenAI
client = OpenAI(api_key="sk-你的令牌", base_url="https://ai.moespark.dev/v1")
r = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好！"}],
)
print(r.choices[0].message.content)

// Node.js
import OpenAI from "openai";
const client = new OpenAI({ apiKey: "sk-你的令牌", baseURL: "https://ai.moespark.dev/v1" });
const r = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好！" }],
});
console.log(r.choices[0].message.content);

更多语言示例见 多语言 SDK 示例。

接入自检清单

• ✅ Base URL 是否为 https://ai.moespark.dev/v1（OpenAI 兼容）
• ✅ 是否使用 Authorization: Bearer sk-... 头
• ✅ model 是否为控制台「模型价格」中真实存在的名字
• ✅ 令牌额度是否充足、是否过期
• ✅ 是否被浏览器 CORS 拦截（后端调用不会有此问题）