Recraft 余额查询：API units 与 Token 接入教程

不托管 Token，如何手动查余额？

1. 登录 Recraft 官方 Profile → API，核对实际调用账户。
2. 读取 API units，而非 Studio 订阅额度；1,000 API units = $1 美元面值，不是退款或现金承诺。
3. 记录账户与时间；如需对比本站，刷新一次并对齐相同字段。手动查看不需要向任何人提供 Token。

在 Quota Monitor 中接入 Recraft

1. 01

   确认账户和 API 余额入口

   打开下方 Recraft 官方 Profile → API 页面，用应用实际使用的账户登录。找到 API units 余额，记下账户、单位与查询时间。

   完成后检查：这里是 API 账户，不是 Studio 工作区的订阅 Credits；通过 fal.ai 等第三方使用模型时，应监控实际付费平台。

   打开 Recraft Profile → API（在新标签页打开）
2. 02

   检查创建 Token 的前提与授权范围

   官方 Quickstart 说明 Generate 需要正 API units 余额。若余额为零或不能创建，先使用官方页面手动查看；不要为验证监控而盲目付款。

   普通 Token 可执行收费模型操作，未提供已确认可用的余额专用只读策略。确认你有权授权且组织允许托管；如果必须只读，请停在这里，不提供登录会话或管理员凭据。

   官方 Token 获取说明（在新标签页打开）
3. 03

   创建独立 API Token

   在同一 Profile → API 页面点击 Generate，生成仅供 Quota Monitor 使用的 Token，不修改现有业务 Token。若界面没有名称字段，在自己的密码管理器中记录用途与创建时间。

   完成后检查：获得一个新的完整 Token，账户没有切换。官方未列出本接入可用的只读 scope 或权限 JSON；不要把自行填写的权限名称当成已生效的保护。

   生成独立 Token（在新标签页打开）
4. 04

   安全复制并保存 Token

   将新 Token 保存到可信密码管理器，仅复制完整秘密值。粘贴时不带 Authorization: Bearer、引号、空白或掩码字符；不要用邮箱、Token 名称代替。

   完成后检查：记录的是 API Token，而非网页登录 Cookie。不要发送到聊天、截图、工单、网址或 MCP 参数；MCP 用户通过本站安全录入链接填写。

   查看官方 Bearer 鉴权说明（在新标签页打开）
5. 05

   在目标项目内添加 Recraft

   回到 Quota Monitor，打开目标项目，添加供应商连接并选择 Recraft（API units · 美元面值），填写连接名称，将 Token 粘贴到遮蔽密钥框后保存。

   完成后检查：连接属于目标项目。账户由 Token 决定，不填写自定义 API 地址、供应商项目或 Key ID；币种固定 USD，凭据加密存储。

6. 06

   执行首次只读同步

   等待首次同步，或使用查询最新余额按钮。本站仅发送固定余额 GET，不生成图像、不管理 Token、不购买或自动充值。

   完成后检查：卡片有新的成功时间、美元面值和原始 API units。失败时阅读下方排错；已有旧快照的时间不会被伪装成刚刚成功。

7. 07

   按同一账户和单位对账

   回到相同账户的 Profile → API，在接近时间比较余额。例如 credits=24500 应显示 24500 API units 和 $24.5，不是 $24500；公式是 credits / 1000。

   完成后检查：REST/MCP 的 recraftBalance.balance 与卡片美元面值相同，credits 与官方原始单位相同。告警阈值使用 USD，不拿 Studio 额度或某次生成消耗对账。

   官方 API units 与美元比例（在新标签页打开）
8. 08

   管理资金、轮换与真实验收

   余额不足时点击卡片前往平台，核对账户后由有付款权限的人自行决定是否购买 API units。轮换时先生成替代 Token、安全更新连接并核对成功，再撤销旧监控 Token，不操作业务 Token。

   完成后检查：删除本站连接或项目关联不会撤销官方 Token。请用真实账户验收创建过程、金额和本教程；反馈只提供脱敏错误码及时间，不提供 Token。

   返回官方账户页面（在新标签页打开）

Quota Monitor 读取的 Recraft 数据范围

• API units 与 Recraft Studio 的订阅、免费或每日额度分开；第三方托管 Recraft 模型也使用第三方自己的账单。
• 仅 /users/me 的 credits 是剩余余额；图像生成响应中同名 credits 是本次请求消费，不能当余额。本接入不调用任何生成接口。
• 同一账户的所有 Token 共享 API units。不同本站项目重复绑定同账户时不要相加，也不要再次扣减消费。REST/MCP 的 recraftBalance.balance 和 credits 来自同一快照。
• 官方说明生成新 Token 需要 API units 余额大于零。没有余额时可以先手动查看；本站不会为了接入要求或代为购买、启用自动充值。
• 保留零和负数。查询失败、缺失或无效数值保留旧金额及时间，不伪造零。正余额不保证模型可调用；不保存接口返回的邮箱、姓名或用户 ID。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Recraft 常见问题与排查

Generate 不可用或账户没有 API units？

官方将创建 Token 与正 API units 余额绑定。先确认实际使用账户和 API 余额页面；没有余额时先手动查看。不要为测试自动付款，也不要用 Studio 额度、Cookie 或别人的 Token 绕过。

HTTP 401 或 Token 格式被拒绝？

从 Profile → API 重新核对完整 Token，去掉 Bearer 前缀、引号和空白，确认没有撤销。不要提交 Token 名称、邮箱或浏览器登录令牌，也不要把秘密发送给客服。

HTTP 403 或需要严格只读权限？

确认账户及组织是否允许托管独立 API Token。没有文档化余额专用权限时不能声称凭据只读；请手动查账或联系 Recraft 支持，不扩大管理员权限，不关闭现有业务安全限制。

为什么美元金额比 API units 小 1,000 倍？

API 返回 credits，官方定义 1,000 API units = $1。本站同时显示原始单位和精确美元面值；已扣除的消费不再减一次。付款税费、折扣和 Studio 订阅不是这个余额字段。

不同项目金额相同，或 Studio 仍有 Credits？

同账户 Token 共用 API units，本站项目只用于分组，重复快照不要汇总。Studio 与 API 额度分开；通过其他厂商使用 Recraft 时也不能用此账户余额替代实际账单。

HTTP 404、429、跳转或无效响应？

记录脱敏错误码和时间。429 等待计划重试或手动刷新冷却结束；404 或格式变化需要核对官方文档。查询失败保留旧快照，不推断零余额，不尝试 Cookie、私有接口或收费生成请求。

Recraft 官方资料

• 官方余额端点与响应（在新标签页打开）
• 官方 Token 创建与鉴权（在新标签页打开）
• 官方 API units 价格与共享范围（在新标签页打开）
• 官方 API 与 Studio 计费常见问题（在新标签页打开）

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