教程更新
根据 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 余额
- 登录 dev.runway.com,选实际付费调用 API 的项目,而不是网页应用工作空间。
- 打开项目 Billing,读取 Credits;如果页面同时显示美元,按 100 Credits = $1 核对。
- 需要补款由已有 Admin 或 Billing admin 在此项目操作;多个 Key 共用该项目金额,不与网页订阅或其他 API 项目直接合并。
在 Quota Monitor 中接入 Runway
先确认付费的是开发者 API 项目
打开 Runway Dev(dev.runway.com)并登录,选择实际调用 API 的项目。没有 API 项目的用户需先在开发者门户创建;已有项目不要为查余额另建空项目。
进入该项目的 Billing,记录当前 Credits 和项目名称供自己核对。完成检查:看到的是开发者项目金额,而不是网页 Standard、Pro、Unlimited 等订阅额度。
确认创建 Key 的权限
在目标项目进入 API Keys(新版导航可在 Manage 下)。已有 Developer 或 Admin 可以创建和停用 Key;Billing admin 管理资金但不能创建 Key。
没有按钮时请现有项目管理员协助创建专用 Key,不要为排错把监控人员升级为 Admin。角色是人员权限,不代表生成的 Key 只读;只读托管要求无法满足时使用手动查询步骤。
为 Quota Monitor 新建专用 Key
在 API Keys 使用新建密钥操作,为它命名,例如 Quota Monitor balance。确认仍在目标 API 项目,再完成创建,不复用正在生产调用的 Key。
完整 Key 只显示一次,立即存到密码管理器。丢失时创建替代 Key,不尝试从网页会话提取秘密值。完成检查:保存的是完整 API Key,而不是名称、前缀或浏览器 Cookie。
在本站业务项目内添加连接
返回 Quota Monitor,打开需要监控的业务项目,选择添加供应商连接,再选 Runway(API Credits · 美元面值)。为连接起能区分上游项目的名字,如 Runway · Video production。
把完整值填到遮蔽的 API Key 输入框,不带 Bearer 或请求头。只需要一项凭据,不填上游项目 ID;币种固定 USD。若由 MCP 发起,用安全录入链接填 Key,不在对话中发送。
保存并等待首次同步
检查连接名称和供应商后保存;等待首次同步,或在刷新冷却结束后查询最新余额。成功判据是查询时间更新、显示数值和原始 Credits,而不是一直停在等待状态。
列表仅显示 Key 末四位,后端加密保管。401、403、429 或格式错误不是零余额;失败时查看最后成功时间与脱敏错误码,不把原始响应或 Key 发给支持人员。
与同一个 Runway 项目对账
回到 Runway Dev 的同一 API 项目,打开 Billing 比较原始 Credits;例如 2450 Credits 对应本站 $24.5。若官方页面显示美元,按 100 Credits = $1 核对,而不是拿模型价格反推。
不要扣除 usage 再算余额,也不要把 tier.maxMonthlyCreditSpend 当成可用资金。需要监控另一个 API 项目时,使用那个项目的 Key 建立单独连接;同一项目多个连接不能重复汇总。
需要补款时打开官方平台
发现 Credits 不足,可点卡片的 Open provider,登录并核对项目,再进入 Billing,由已有 Admin 或 Billing admin 按官方页面完成购买。本站不收取充值款、不替你付款或调整自动充值。
购买或获准的企业额度转移入账后,再刷新并核对同一项目。不要因为网页订阅有额度就认定 API 也有钱;若官方尚未入账,刷新不会加快结算。
轮换或停用监控密钥
在同一 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 官方资料
- Runway 官方 OpenAPI:creditBalance 与版本头(在新标签页打开)
- Runway API 设置、建 Key 与补款(在新标签页打开)
- Runway 项目与角色权限(在新标签页打开)
- Runway API Credits 官方计价(在新标签页打开)
- Runway API 常见问题及网页额度区别(在新标签页打开)
- 企业组织中的 API 项目与 Credits 转移(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。