Kie.ai 余额查询与 API Key 接入教程

不提交 Key，如何手动查 Kie.ai 余额？

1. 登录 kie.ai，确认实际为 API 付费的账户或团队。
2. 打开 Billing，查看剩余 Credits；200 Credits = $1 美元面值，不是累计花费或某个 Key 的消费限额。
3. 需要补充才在官方充值，到账后再核对；不要为查询余额把 Key 发给他人。

在 Quota Monitor 中接入 Kie.ai

1. 01

   1. 登录 Kie.ai 并确认目标账户

   打开下方 Billing 链接，按提示登录实际付费调用 Kie.ai API 的账户。若加入过团队，先核对当前付费账户，再记下页面显示的 Credits 和时间；不要用模型原厂网站或聊天订阅金额作比较。

   完成后检查：可以查看正确账户的 Credits。无需为了接入而充值、运行生成任务或加入新团队；只想手动看余额可以停在这里。

   打开 Kie.ai Billing（在新标签页打开）
2. 02

   2. 创建独立的监控 API Key

   保持同一账户，打开 API Keys，点击 Create New Key（部分界面为 Create API key）。在 Name 填入 Quota Monitor，点击 Create Key；不要复制现有业务 Key。没有创建权限时请已有管理员协助。

   完成后检查：创建成功并出现 Secret Key。把这个新 Key 标记为仅供监控使用，但名称本身不会限制权限；不要以为写上 Read Only 就会变成只读。

   打开 Kie.ai API Keys（在新标签页打开）
3. 03

   3. 理解权限与可选安全限制

   普通 Key 可以消耗 Credits 调用模型。API Keys 中的 Allowed Models、Safe-Spend Limits 和 IP Whitelist 可以缩小风险，但当前官方没有已确认兼容的余额专用只读权限。若采用限额，请注意界面的 0 表示不限制，而非禁止消费。

   完成后检查：你接受本站加密保管此 Key。不要为排错扩大到 All Models 或取消已有安全限制；IP 白名单必须使用监控服务器已确认的固定出站 IP，不能填自己电脑或网站域名。本服务未承诺固定出站 IP，如白名单是强制要求，请先手动查询。

   官方 Key 安全说明（在新标签页打开）
4. 04

   4. 保存完整秘密值

   在成功界面使用 Copy key / Copy 复制 Secret Key，先保存到密码管理器，再关闭弹窗。页面提示秘密值可能不会再次展示；若已经丢失，重新创建，不使用掩码或末四位。

   完成后检查：复制的是完整 Key，不包含 Authorization: Bearer、引号、换行或前后空格。不要放到聊天、截图、工单、URL 或第三方在线 API 测试器中。

   管理专用 API Key（在新标签页打开）
5. 05

   5. 在目标项目内添加 Kie.ai

   回到 Quota Monitor → 目标项目 → 添加供应商连接 → 添加新连接，选择 Kie.ai（Credits · 美元面值）。填写连接名称，把完整值粘贴进 Kie.ai API Key 密码框并保存。

   完成后检查：只有一个 Key 输入框，不需要 API 地址、Account ID、上游项目或 Key ID，币种固定 USD。秘密值加密存储；通过 MCP 创建连接时只在安全录入链接中填写，不把 Key 交给 Agent。

6. 06

   6. 同步并核对 Credits 与美元面值

   等待首次同步或点击查询最新余额，确认出现新的成功时间，再与同一付费账户 Billing 的 Credits 对比。例如 4900 Credits 应同时显示 $24.5 与 4900 Credits，而不是 $4900。

   完成后检查：美元面值为 credits / 200，无需再减消费；告警阈值和日消耗配置使用 USD，不是 Credits。首次验收记录脱敏金额、账户范围和查询时间即可，不分享完整响应或密钥。

   核对账户 Credits（在新标签页打开）
7. 07

   7. 需要补充 Credits 时前往官方付款

   余额不足时点击卡片的前往平台按钮打开 Billing，再次确认账户。确需购买时，由有付款权限的人按当前充值页面选择金额、核对费用并自行完成付款；监控接入本身不要求购买。

   完成后检查：官方 Credits 已增加后再刷新本站。充值优惠、赠金、税费及退款以官方当前条款为准，美元面值不是退款承诺，本站不会自动充值或改变付款方式。

   官方 Billing 与充值入口（在新标签页打开）
8. 08

   8. 更换并撤销旧的监控 Key

   需要换钥时在 API Keys 创建替代 Key，建立新连接并验证余额；再移除旧连接的所有项目引用并删除旧连接。最后回到 Kie.ai 对旧监控 Key 使用 Revoke Key 并确认，务必核对名称，不撤销业务 Key。

   完成后检查：新连接同步成功、旧 Key 已撤销。本站移除或删除连接不等于官方撤销；官方若不允许删除最后一个 Key，先保留可用替代 Key 并按页面提示处理，不因此误删其他账户凭据。

   撤销旧监控 Key（在新标签页打开）

Quota Monitor 读取的 Kie.ai 数据范围

• Kie.ai 是多模型服务平台，此接口只读 Kie.ai 账户资金，不读取模型原厂账户或聊天产品订阅。多个项目与 Key 共用同一账户 Credits 时，不能重复相加。
• 美元面值 = credits / 200，不根据模型单价或历史用量估算，也不再次扣减费用。Credits 不是可提现现金，充值赠金或优惠意味着面值不等于实际支付金额；本接口未提供现金/赠金拆分、到期或逐模型配额。
• 查询时间不等于计费结算时间，不保证零延迟或余额大于零就能调用。Key 的模型限制、Safe-Spend Limits 和 IP Whitelist 仍可能阻止请求，本版不读取这些限额。
• 只有成功业务码 code=200 且 data 为有效数值才更新余额。HTTP 200 内的 401、402、429、455 等错误不是零余额；失败会保留上次成功快照及其时间。本接入不发起模型生成、充值或账户修改。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Kie.ai 常见问题与排查

401、403 或 Key 格式错误怎么办？

从 API Keys 重新复制完整专用 Key，检查撤销状态、账户权限及 IP Whitelist，去掉 Bearer 前缀与空格。不要提交 Cookie，不为排错关闭安全要求或扩大权限。无法满足固定出站 IP 要求时先用官方 Billing。

为什么与官方显示的数字相差 200 倍？

data 是 Credits 而非美元：4900 Credits = $24.5。本站保留两种单位，告警按 USD 设置。不把赠金面值当实付现金，不把原厂钱包或单独订阅加进来。

多个项目相同，或 Key 达限额但余额仍大于零？

接口读账户共享 Credits，不读单 Key 的 Safe-Spend Limits 或逐模型限额。本站项目只是分组，同一账户不要重复加总。余额为正也可能因模型权限、Key 限额或其他限制无法调用。

HTTP 200 却失败，或出现 402、429、455？

HTTP 成功不等于业务成功。只有 code=200 和合法 data 才算余额。402 不是可替代余额的数字零；429 是限流，455 是维护，稍后再试。本站不切换私有端点或估算余额，失败保留旧查询时间和数值。

充值没显示或找不到专用 Key？

确认充值到了同一付费账户并已入账，再刷新；近期计费可能尚在更新。Key 秘密值丢失则创建替代 Key 并验证后撤销旧 Key，不复用生产凭据。仍不一致只反馈脱敏金额、错误码和时间，不发送原始响应。

Kie.ai 官方资料

• 官方 Get Account Credits API（在新标签页打开）
• 官方账户、共享 Credits 与 Key 安全说明（在新标签页打开）
• 官方 Credits 查询入门与错误码（在新标签页打开）
• 官方每 Credit $0.005 的价格说明（在新标签页打开）
• 官方 API Keys 控制台（在新标签页打开）

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。