Runway API 余额查询:Credits、密钥与接入教程

逐步查看 Runway API Credits、创建专用密钥并接入余额监控。区分开发者项目与网页订阅,了解美元面值、权限风险和首次同步对账。

待真实账号验证

教程更新

根据 Runway 官方 OpenAPI、开发者设置与角色文档实现,待真实账号验证。尚未登录走通建 Key、权限与余额对账;自动测试不能替代真实验收。

所需凭据
Runway Dev API Key
监控币种
USD · Credits 美元面值
可以看到什么
API Credits · 美元面值
固定 GET https://api.dev.runwayml.com/v1/organization,以 Bearer Key 和 X-Runway-Version: 2024-11-06 读取 creditBalance。接口称 organization,当前 Runway Dev 界面称项目;以 Key 所属范围为准,项目内多个 Key 共享 Credits。美元面值为 credits / 100(100 Credits = $1),不是本站项目自动分配的钱包。

不提交 Key,手动查看 Runway API 余额

  1. 登录 dev.runway.com,选实际付费调用 API 的项目,而不是网页应用工作空间。
  2. 打开项目 Billing,读取 Credits;如果页面同时显示美元,按 100 Credits = $1 核对。
  3. 需要补款由已有 Admin 或 Billing admin 在此项目操作;多个 Key 共用该项目金额,不与网页订阅或其他 API 项目直接合并。
打开 Runway 开发者门户(在新标签页打开)

在 Quota Monitor 中接入 Runway

  1. 先确认付费的是开发者 API 项目

    打开 Runway Dev(dev.runway.com)并登录,选择实际调用 API 的项目。没有 API 项目的用户需先在开发者门户创建;已有项目不要为查余额另建空项目。

    进入该项目的 Billing,记录当前 Credits 和项目名称供自己核对。完成检查:看到的是开发者项目金额,而不是网页 Standard、Pro、Unlimited 等订阅额度。

  2. 确认创建 Key 的权限

    在目标项目进入 API Keys(新版导航可在 Manage 下)。已有 Developer 或 Admin 可以创建和停用 Key;Billing admin 管理资金但不能创建 Key。

    没有按钮时请现有项目管理员协助创建专用 Key,不要为排错把监控人员升级为 Admin。角色是人员权限,不代表生成的 Key 只读;只读托管要求无法满足时使用手动查询步骤。

  3. 为 Quota Monitor 新建专用 Key

    在 API Keys 使用新建密钥操作,为它命名,例如 Quota Monitor balance。确认仍在目标 API 项目,再完成创建,不复用正在生产调用的 Key。

    完整 Key 只显示一次,立即存到密码管理器。丢失时创建替代 Key,不尝试从网页会话提取秘密值。完成检查:保存的是完整 API Key,而不是名称、前缀或浏览器 Cookie。

  4. 在本站业务项目内添加连接

    返回 Quota Monitor,打开需要监控的业务项目,选择添加供应商连接,再选 Runway(API Credits · 美元面值)。为连接起能区分上游项目的名字,如 Runway · Video production。

    把完整值填到遮蔽的 API Key 输入框,不带 Bearer 或请求头。只需要一项凭据,不填上游项目 ID;币种固定 USD。若由 MCP 发起,用安全录入链接填 Key,不在对话中发送。

  5. 保存并等待首次同步

    检查连接名称和供应商后保存;等待首次同步,或在刷新冷却结束后查询最新余额。成功判据是查询时间更新、显示数值和原始 Credits,而不是一直停在等待状态。

    列表仅显示 Key 末四位,后端加密保管。401、403、429 或格式错误不是零余额;失败时查看最后成功时间与脱敏错误码,不把原始响应或 Key 发给支持人员。

  6. 与同一个 Runway 项目对账

    回到 Runway Dev 的同一 API 项目,打开 Billing 比较原始 Credits;例如 2450 Credits 对应本站 $24.5。若官方页面显示美元,按 100 Credits = $1 核对,而不是拿模型价格反推。

    不要扣除 usage 再算余额,也不要把 tier.maxMonthlyCreditSpend 当成可用资金。需要监控另一个 API 项目时,使用那个项目的 Key 建立单独连接;同一项目多个连接不能重复汇总。

  7. 需要补款时打开官方平台

    发现 Credits 不足,可点卡片的 Open provider,登录并核对项目,再进入 Billing,由已有 Admin 或 Billing admin 按官方页面完成购买。本站不收取充值款、不替你付款或调整自动充值。

    购买或获准的企业额度转移入账后,再刷新并核对同一项目。不要因为网页订阅有额度就认定 API 也有钱;若官方尚未入账,刷新不会加快结算。

  8. 轮换或停用监控密钥

    在同一 API 项目的 API Keys 创建替代专用 Key,通过本站安全页面更新连接,确认新 Key 同步成功,再停用旧 Key。若怀疑泄露,先在官方立即停用,不等待常规轮换。

    停用连接或移除本站项目关联,不等于在 Runway 撤销 Key。Runway Key 属于项目,移除某个成员也不会自动撤销;需由 Developer 或 Admin 在 API Keys 中单独停用。

Quota Monitor 读取的 Runway 数据范围

  • 仅监控 Runway 开发者 API 项目的余额,不查询网页订阅或其他托管商的资金。企业可获准在网页工作空间和 API 项目间转移 Credits,但本站只读取最终落在此 API 项目的金额,不汇总整个企业资金。
  • 原始 Credits 与精确美元面值同时显示;面值不是可提现现金、实际含税付款金额或单 Key 预算。不再次扣减用量,同一 API 项目不能跨连接重复累加。tier.maxMonthlyCreditSpend 是购买上限,不是剩余余额。
  • 官方 creditBalance 契约为非负整数;缺字段、负数、小数、格式错误或请求失败均保留上次成功快照及时间,不猜测或填零。查询时间不等于结算时间,正余额也不能保证生成成功。
  • 固定使用 api.dev.runwayml.com,不接受自定义地址或另一个项目 ID。本站不读取生成内容、不发起生成、付款、充值或自动充值修改;没有确认余额专用只读 Key。
  • 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商,但不保证上游账务没有入账延迟;失败时旧余额不能当成新结果。

Runway 常见问题与排查

401 或 403,应该加管理员权限吗?
先确认选中 Runway,Key 是目标开发者项目的完整值,未停用且不带 Bearer、空格或 Cookie。人员 Developer 可管理 Key,但这不是余额只读权限。请已有管理员核对项目和 Key,不盲目升级到 Admin;凭据仅通过安全页面轮换。
网页明明有 Credits,为什么 API 是零?
网页应用与开发者 API 独立记账。企业的可用转移功能也不会把所有工作空间自动合成一个余额;先确认 Credits 已实际转入这个 API 项目。零是有效查询结果,不代表已测定所有模型的可用性。
organization 和项目是不是同一回事?
这个接口仍叫 /v1/organization;当前开发者门户把 Key 与资金归属叫项目。本站用 api_project 标记这种上游范围,由 Key 选择,不是 Quota Monitor 的业务项目,也不是整个企业所有工作空间的总账。
余额和使用等级的上限应该相减吗?
不用。creditBalance 已是剩余 Credits,100 Credits = $1 只用于面值换算。tier.maxMonthlyCreditSpend 是购买上限,usage 是使用信息,都不能再次从 Credits 扣减。同项目多个 Key 的相同余额不能相加。
充值后未变化、429 或格式错误怎么办?
先在同一项目 Billing 确认官方入账,再等待冷却后刷新;429 不要连续重试。本站只采信官方契约,缺字段或非整数等异常保留旧结果和时间,不改成零。只反馈脱敏错误码、时间和项目范围,不发 Key。
没有可用只读 Key,能用 Cookie 或第三方 Key 吗?
不能。本站只接受官方开发者 API Key,不能用网页会话、Cookie、Kie.ai 等托管商 Key 或自定义端点替代。若不能承担普通 Key 可生成付费内容的风险,请用手动查询,不要扩大权限。

Runway 官方资料

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

自动监控 Runway

手动登录控制台查看很容易忘。Quota Monitor 会通过官方接口替你读取 Runway 的数据。

  • 默认每 10 分钟刷新一次,也可以随时手动刷新。
  • 余额不足、Key 失效或同步失败会排在总览最上方。
  • 按项目查看各平台账号,也可以通过远程 MCP 在 Claude 等 AI 助手里直接询问余额。
免费开始使用