♪Suno API 中文教程

Suno API 接入的可观测性

如果只记录 HTTP 状态码,你会漏掉真正花钱的失败:重复提交、卡住的任务和过期的媒体地址。

一条任务一行日志

至少记录:自己的 request_id、平台任务 ID、租户/账号、模型、提交时间、每次状态变化、下载时间、最终费用。request_id 用来幂等,任务 ID 用来重启后找回结果。

抓钱漏的指标

指标能发现什么
429 比例突发、缺退避、并发过高
p95 提交到完成上游变慢
终态失败率账号、内容或模型问题
重复提交率超时后被当成新订单
每首成功歌曲成本失败和重复扣费

值得告警的事

429 突增、失败率明显变化、任务超过阈值仍无终态、完成量突然归零。不要为每一次重试告警;按租户和任务类型聚合。

常见问题 / FAQ

最重要的字段是什么?

平台任务 ID。没有它,服务重启后无法找回正在生成的结果。

要记录提示词吗?

只在隐私政策允许时记录;优先存哈希或脱敏摘要,提示词可能包含客户数据。

失败率怎么告警?

看滚动窗口的比率变化,不要因单次失败告警;连续失败才是事件。

申请 Key、第一个请求、接口清单与报错排查
注册只需要邮箱,一次生成 0.6 元出 2 首,MP3 与 WAV 下载不限次。
看任务生命周期