API 运营
余额不足或预扣失败怎么排查
读取可用余额、处理中预扣和待冲抵金额,再核对本次报价。
看可用余额字段
GET /v1/balance 返回 available_usd、held_usd 和 payment_debt_usd。显示金额是美元。已有任务可能占用一部分额度,因此不要用历史充值额判断当前可用余额。
从报价看本次会扣多少
POST /v1/quotes 返回展示价和实际扣费金额。改变分辨率、生成时长或输出数量后应重新报价。HTTP 402 insufficient_balance 说明本站账户的可用余额未覆盖预扣。
按错误决定下一步
余额不足时暂停任务提交,减少规格后重新取价或等待已有预扣释放。查不到账单时先用原幂等键确认受理状态。线上充值是否开放以余额页为准。
查询账户余额
curl "https://apimodel.store/v1/balance" \ -H "Authorization: Bearer $MODELPORT_API_KEY"