Skip to main content
每个咏唱引擎账户都持有一个预付费钱包。你通过受支持的支付提供方为其充值，计量用量从余额中扣减。钱包币种由站点域名固定，与你所浏览的界面语言无关。

​
币种

即使你以英文浏览中国站，价格仍为人民币。两个站点的钱包互不共享：各自拥有独立的余额、交易与发票。

​
充值流程

  1. 客户端从 GET /api/payments/providers 获取可用提供方。
  2. 通过 POST /api/billing/payments 发起充值，获得 Stripe 结账 URL、微信支付二维码或支付宝二维码。
  3. 你在提供方的流程中完成支付。
  4. 提供方通过 webhook 调用 POST /api/payments/webhook/{provider}，后端为钱包入账。
  5. 你可轮询 GET /api/billing/payments/{id} 查询状态。
提供方在凭证配置完成前处于禁用状态。使用 GET /api/payments/providers 查看当前环境中哪些提供方已生效。

​
用量

用量按计量上报，通过 GET /api/billing/usage 查询。每次模型调用、模型下载与 GPU 小时，均依据 GET /api/pricing 公布的费率计价，并从你的钱包扣减。你可通过 GET /api/billing/transactions 查看产生的交易。

​
发票与收据

每笔已支付款项都可生成一份可供下载与存档的凭证。
  • 中国站（ariacompute.cn）：微信支付与支付宝付款可开具电子发票（电子发票）。通过 POST /api/billing/invoices 申请，并从 GET /api/billing/invoices/{paymentId}/download 下载。每笔付款对应一张发票，幂等。
  • 国际站（ariacompute.com）：Stripe 付款提供收据，可从 GET /api/billing/receipts/{paymentId}/download 获取。
两个下载接口均接受通过 Authorization: Bearer 或 ?token= 查询参数传递的会话令牌，以便浏览器链接直接可用。

​
相关