安全警示 · 火山引擎管控面密钥

这把密钥能做什么（管控面权限范围）

• 查询与管理方舟（Ark）推理接入点、模型服务配置；
• 读取套餐订阅、配额额度与用量明细（本看板全部功能的来源）；
• 查看账号维度的账单与费用信息；
• 使用 IAM 子账号时，权限以授权策略范围为上限。

为什么危险

• 主账号密钥一旦泄露 ≈ 整个火山引擎账号被接管：别人可以创建 / 删除资源、产生真实费用；
• 管控面密钥不是「只读」凭据，任何拿到它的人都能执行管理操作；
• 密钥泄露后应立即在控制台禁用并轮换，只删除不轮换仍有风险窗口。

降低风险的建议

1. 用 IAM 子账号单独生成密钥，并授予最小权限策略（仅方舟管控面查询所需权限）；
2. 不要把主账号 AK/SK 填入任何不信任的第三方工具；
3. 定期到「访问控制 → 访问密钥」轮换密钥。

本站如何保管

• 密钥加密后仅保存在你自己的账号下，其他用户与访客无法查看；
• 前端展示 SK 时默认打码，可在「设置、配置 → 火山引擎」随时删除。

安全警示 · AI 网关令牌

令牌能做什么

• 调用网关管理接口（用量统计等），按多个维度查询各用户 / 模型的消耗；
• 管理级令牌可看到全网范围的数据，普通令牌仅限自身用量。

为什么危险

• 管理令牌泄露 = 网关全部用量数据（可能含其他用户）可被第三方读取；
• 拿到令牌的人可能进一步探测网关的管理能力。

本站如何保管

• 令牌加密后仅保存在你自己的账号下，前端默认打码显示；
• 可在「设置、配置 → AI 网关」随时删除；怀疑泄露请立即在网关后台重置令牌。

调用教程 · 火山引擎（方舟）

密钥与接口在哪里找

1. 推理用 API Key：火山引擎控制台 → 方舟（大模型服务平台）→「API Key 管理」新建。 调用模型时用它（本看板的额度看板不用它）；
2. 管控面 AK/SK：火山引擎控制台 → 账号 →「访问控制 IAM」→「访问密钥」。 本站「设置、配置 → 火山引擎」填的就是这对密钥；
3. 推理接入点：方舟控制台 →「在线推理」→ 创建推理接入点，得到 ep- 开头的接入点 ID （部分模型可直接用模型 ID 调用）。

怎么调用（OpenAI 兼容协议）

• 接口地址：https://ark.cn-beijing.volces.com/api/v3/chat/completions
• 鉴权头：Authorization: Bearer <ARK API Key>
• 模型参数：填接入点 ID（ep-xxx）或模型 ID。

from openai import OpenAI

client = OpenAI(
    api_key="你的 ARK API Key",
    base_url="https://ark.cn-beijing.volces.com/api/v3",
)
resp = client.chat.completions.create(
    model="doubao-seed-2.1-turbo",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

官方文档：火山引擎「方舟（大模型服务平台）」文档中心的「快速入门 / API 参考」。

调用教程 · AI 网关（基元律动）

令牌在哪里找

1. 打开网关 https://ai.mitao666.top 并登录；
2. 进入「令牌 / Token 管理」新建一个令牌；
3. 把令牌填进本站「设置、配置 → AI 网关」（网关地址填 https://ai.mitao666.top）。

怎么调用（OpenAI 兼容协议）

• 接口地址：https://ai.mitao666.top/v1/chat/completions
• 鉴权头：Authorization: Bearer <你的网关令牌>
• 模型清单：见「模型广场 → AI 网关」页签。

curl https://ai.mitao666.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的网关令牌" \
  -d '{"model": "模型ID", "messages": [{"role": "user", "content": "你好"}]}'

任何 OpenAI SDK 客户端都可以：把 base_url 指到网关地址、api_key 换成网关令牌即可。

常见问题 · 火山引擎

• 密钥安全吗？所有凭据加密后仅保存在你自己的账号下，其他用户与访客都无法查看。
• 数据多久刷新一次？看板每 30 秒自动刷新，也可以点右上角「刷新」手动更新。
• 提示 InvalidAccessKey？AccessKey ID 必须是 AKLT 开头的管控面密钥；AKID / AKTP 开头的不是方舟管控面用的密钥。
• 提示 SignatureDoesNotMatch？AK 与 SK 必须来自同一对密钥，请重新复制。
• 提示 AccountNotAuthorized / AccessDenied？账号未开通方舟服务，或该密钥无权访问管控面接口（子账号请检查授权策略）。
• 预估价怎么算的？按（输入价 + 输出价）÷ 2 的均价 × 你的折扣估算，实际账单以火山官方为准。
• 峰谷价格怎么回事？DeepSeek 系模型分高峰 / 空闲两档价：北京时间工作日 9:00–12:00、14:00–18:00 为高峰，其余时段空闲价。

常见问题 · AI 网关

• 网关地址填什么？填 https://ai.mitao666.top；域名必须 https（需要有效证书），只有 IP 直连才允许 http。
• 令牌从哪来？网关后台「令牌 / Token 管理」新建；填进本站后即可查看用量统计。
• 用量统计能看多久？六个维度各最多返回 20 条记录，按天 / 模型 / 用户等维度汇总。
• 为什么广场里看不到 AI 网关模型？公开价目里没有网关模型；配置网关令牌后，在「模型广场」的 AI 网关页签查看私有清单。