用户操作手册 · 操作手册下载 Markdown

用户操作手册

欢迎使用 智优 MaaS —— 一站式 AI 模型聚合调用平台。本手册帮助你快速拿到密钥、发起第一次调用，并看懂账单。

1. 获取你的 API 密钥

1. 注册并登录后，默认进入「首页」智能体对话。点击左侧 API 令牌 进入密钥页。

2. 系统已为你自动签发一个主令牌（名称「主令牌」），状态为启用、额度跟随你的账户余额。

3. 点击 查看完整密钥 复制 sk-xxxx（需手机短信验证）；如担心泄露，可随时 重置密钥（旧 key 立即失效）。

4. 你也可以点击 + 新建令牌 创建多个子令牌（用于不同业务/环境隔离）。每个令牌行都有「查看密钥」按钮，同样验证后即可查看；首次短信验证后 10 分钟内查看其它令牌无需重复收短信。每次查看都会记入审计日志。

2. 调用方式（OpenAI 兼容）

Base URL：https://<你的服务器域名>/v1
认证：Authorization: Bearer <你的 sk-密钥>
协议：完全兼容 OpenAI API 格式

curl -X POST https://<你的服务器域名>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "qwen-long",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python 示例：

from openai import OpenAI
client = OpenAI(api_key="sk-你的密钥", base_url="https://<你的服务器域名>/v1")
resp = client.chat.completions.create(
    model="qwen-long",
    messages=[{"role": "user", "content": "介绍一下你自己"}]
)
print(resp.choices[0].message.content)

3. 模型与额度

你的令牌允许调用的模型由管理员/代理分配，页面「我的 API 密钥」下方可见。
未定价的模型无法被调用，调用时会提示「该模型未定价」。
计费单位：额度。1 元 = 1,000,000 额度（可在系统设置调整 QUOTA_PER_YUAN）。
每次调用按 输入 token × 输入价 + 输出 token × 输出价 从你的余额中扣除。

4. 省钱在哪里

平台售价通常低于模型官网价。令牌页与仪表盘会展示：

累计已为你节省：官网价 − 平台实扣
比官网省了百分之多少
账户余额 与 近 7 日调用 统计

5. 余额预警

在「API 令牌」页设置余额预警阈值（元）。当余额低于该值时，页面顶部会出现预警提示，建议尽快充值。

6. 常见问题

调用返回 402 insufficient_quota：余额不足，联系你的上级（代理/企业）充值。
返回 403 model not allowed：该令牌未授权此模型，请在「允许模型」中确认或联系管理员。
返回 404 no channel：该模型暂未配置可用上游渠道，请联系管理员在「渠道管理」启用。
测试调用按钮：在「API 令牌」页点击「测试调用」，会用你的密钥真实发一句「你好」并展示本次消耗与节省。