计费规则
任务费用如何冻结、扣除和退回。
费用从预充值的美元余额中扣除。在控制台充值,在账单中查看每一笔流水,用 GET /v1/balance 查询余额。各模型的价格见模型页,例如 Genjutsu 价格。
冻结、扣费、退回
| 时机 | 发生什么 |
|---|---|
| 创建任务 | 从可用余额中冻结本次费用;余额不足时返回 402 insufficient_balance,不创建任务 |
| 任务成功 | 扣费:一般等于冻结金额,不会超过它;多冻结的部分退回 |
| 任务失败 | 冻结金额全额退回 |
- 被冻结的钱在任务结束前不能用于其他任务。余额不会变成负数,也不会过期。
- 任务的
billing字段反映冻结、扣费和退回的金额。任务结束后:charged + refunded = frozen。 - 金额是十进制字符串,例如
"4.095"。
余额不足
{
"error": {
"code": "insufficient_balance",
"message": "Your available balance is not enough to create this task.",
"param": null,
"details": { "required": "4.095", "available": "3.00" },
"request_id": "rq_01jb..."
}
}details.required 是这次任务需要的金额,details.available 是可用余额。充值后重新发送请求即可。余额够不够以这个返回为准,不要自己先查余额判断:费用取决于素材,创建任务时才会读取。