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

用户操作手册

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

1. 获取你的 API 密钥

1. 注册并登录后，点击左侧菜单 用户功能 → API 令牌 进入密钥页。

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

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

4. 点击 ＋新建令牌 可创建多个子令牌（用于不同业务/环境隔离），每个令牌需在「允许模型」中勾选要用的模型——漏勾是调用失败最常见的原因。

5. 本页底部 「调用方式」 区域可直接复制你的 Base URL 调用地址。

2. 调用方式（OpenAI 兼容）

Base URL：https://<你的服务器域名>/v1（从「API 令牌」页底部「调用方式」复制）
认证：Authorization: Bearer <你的 sk-密钥>
协议：完全兼容 OpenAI API 格式；模型名以 「可用模型与定价」 页展示的为准（下面以 deepseek-v4-flash 为例）

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

Python 示例：

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

3. 模型与额度

你的令牌允许调用的模型由管理员/代理分配，「API 令牌」页的「允许模型」列可见。
未定价的模型无法被调用，调用时会提示「该模型未定价」。
计费单位：额度。1 元 = 1,000,000 额度。
每次调用的费用 = 普通输入、输出、缓存命中、缓存写入 四类 token 分别乘以对应单价后相加（缓存部分更便宜）；若该模型配置了高峰时段或超长上下文加价，会在调用日志的计费明细中单独列出。
每笔调用的完整计费明细可在 用户功能 → 调用日志 中查看。

4. 省钱在哪里

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

累计已为你节省：官网价 − 平台实扣
比官网省了百分之多少
账户余额 与 近 7 日调用 统计
缓存命中省输入：上下文相同的连续对话会自动命中缓存，命中部分按更低的缓存价计费，仪表盘会显示「节省输入计费 x tokens」——多轮对话无需做任何配置，自动生效。

5. 测试调用与调用日志

测试调用：「API 令牌」页的调用示例代码框中，把 sk-* 替换为你的真实密钥后，点击 「测试调用」** 按钮，会真实发一句「你好」并直接展示本次消耗与节省——第一次接入建议先用它验证密钥可用。
调用日志：左侧 用户功能 → 调用日志 可查每笔调用的状态、报错信息与计费明细，排查问题时先看这里。

6. 余额预警与充值

在「API 令牌」页设置余额预警阈值（元）。当余额低于该值时，页面顶部会出现预警提示。
充值：左侧 财务 → 充值中心；充值记录与消费明细在 财务 → 账单 查看。

7. 常见问题

调用返回 402 insufficient_quota：余额不足，请到「充值中心」充值，或联系你的上级（代理/企业）充值。
返回 403 model not allowed：该令牌未授权此模型：到「API 令牌」编辑令牌，在「允许模型」中勾选要用的模型，或联系管理员。
返回 404 no channel / 找不到模型：模型名拼写与「可用模型与定价」页不一致（注意全小写、短横线），或该模型暂未配置可用渠道，请联系管理员。
返回 401 密钥无效：密钥复制不完整或已被重置，重新「查看完整密钥」复制整串（含开头 sk-）。