跳转到主要内容
GET
查询额度
此端点需要管理 API 密钥。不接受标准 Gateway API 密钥。

通过 CLI 或 API 添加额度

代理和脚本可以通过 POST /v1/credits/topups 或 CLI 发起充值。扣款始终由人来批准。
  • 令牌需要 billing:write 范围。该范围默认从不授予:使用 phaseo login --scopes billing:write 添加,或在管理密钥中列出它。
  • 通过 API 或 CLI 充值的金额为 $5 至 $500;更大金额的充值请在控制台中完成。每个工作区最多同时有 5 个待处理的充值(第六个会返回 429 too_many_pending_topups),每个充值 30 分钟后过期。
  • 尚无已保存的银行卡: 响应中包含 checkout_url。工作区所有者或管理员打开它并用新卡付款,该卡会保存以供之后充值。
  • 已有保存的银行卡: 每位所有者和管理员都会收到一封含一次性链接的邮件。其中一人打开链接、登录并选择 确认 或 拒绝。确认后会从银行卡扣款;如果银行要求,还会进行银行验证。
  • 轮询 GET /v1/credits/topups/{id}(或 phaseo credits topups get <id>),直到 final 为 true。状态为 paid 时会添加额度。declined、expired 和 failed 带有 reason 代码:不要自动重试,请询问相关人员。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

查询参数

workspace_id
string<uuid>

可选的工作区覆盖值。除非由内部控制调用方使用,否则必须与已认证的工作区一致。

响应

额度信息

ok
enum<boolean>
必填
可用选项:
true
credits
object
必填
最后修改于 2026年11月16日