Suno API 余额与用量怎么查
「余额还有多少」「为什么这次扣了」是接入后最常问的两个问题。先把计费边界记住,再谈怎么查。
查余额(免费)
GET /api/user/balance
Authorization: Bearer YOUR_API_KEY余额挂在账号上,不在 Key 上;一个账号可以建多个 Key,但花的是同一份余额。查询接口本身不扣费。
什么会扣费、什么不会
| 类型 | 例子 | 扣费 |
|---|---|---|
| 生成与编辑 | 生成、翻唱、续写、替换段落、分轨、加伴奏、音色翻唱 | 是(生成默认 0.6 元/次出 2 首) |
| 读取 | 状态查询、歌曲列表、余额、媒体地址、下载、时间轴歌词、MIDI | 否 |
下载地址过期后重新取一次不会再次计费——只有重新生成才是新的一单。
账单看起来不对,先查这三处
- 是不是重复提交了:客户端超时后立刻重提,会真的下两单;正确做法是先查任务状态。
- 是不是把编辑类调用算成读取:替换段落、分轨这些会产生新音频,算生成。
- 是不是并发太高触发了限制:429 之后立即重试容易被判为异常请求,建议指数退避。
常见问题 / FAQ
一个账号多个 Key,余额是分开的吗?
不是。余额属于账号,Key 只是调用凭证;按服务拆 Key 便于吊销和看用量,但不会拆开余额。
失败的任务会扣费吗?
任务失败自动退费;如果账单仍有异常,带上歌曲 ID 找客服核对。
能设置用量上限吗?
可以按 Key 拆分不同服务,在平台侧对 Key 做限制;具体入口以控制台为准。
申请 Key、第一个请求、接口清单与报错排查
注册只需要邮箱,一次生成 0.6 元出 2 首,MP3 与 WAV 下载不限次。
去控制台看余额
注册只需要邮箱,一次生成 0.6 元出 2 首,MP3 与 WAV 下载不限次。