计费与配额
积分制。查询余额与消耗。
查询余额
GET /v1/credits
curl "$BASE/v1/credits" -H "Authorization: Bearer $KEY"
响应
{
"data": {
"balance": 10,
"total_earned": 0,
"total_spent": 0,
"daily_free": 0,
"daily_used": 0
}
}
| 字段 | 说明 |
|---|---|
balance | 当前可用积分 |
total_earned | 累计获得 |
total_spent | 累计消耗 |
daily_free | 每日免费额度 |
daily_used | 今日已用免费额度 |
计费规则
- 积分在任务创建时预扣,失败自动退还。
- 创建成功但最终失败,
cost.credits显示实际扣除额(通常为 0,已退)。 - 具体单次价格随模型与引擎不同,以响应中的
cost字段为准。
余额不足
402
{
"error": {
"code": 40201,
"message": "积分不足"
}
}
余额不足不会触发引擎降级——换引擎也解决不了余额问题。 会直接返回 40201。
限流
| 层级 | 默认值 | 说明 |
|---|---|---|
| 单 Key | 20 次/分钟 | 可在创建 Key 时调整 |
| 单用户 | 按账户配置 | 防止多 Key 绕过单 Key 限流 |
触发限流时返回 429。客户端应做指数退避重试。
kemo Music API · 聚合多引擎音乐生成 · 文档随实现同步更新
最后更新:2026-10-23 · 有问题请联系站点管理员
最后更新:2026-10-23 · 有问题请联系站点管理员