♪Suno API 中文教程

Suno API 的回调与轮询:现在该怎么等结果

生成要几分钟,Webhook 看起来更合适;但标准接入路径目前是轮询。把轮询封装成事件,同样能得到稳定的异步体验。

有没有可注册的回调地址

标准路径是 提交 → 查询 → 下载,没有可注册的 callback URL。如果某个服务商声称支持 Webhook,先要它给出事件字段、签名方式、重试策略和补发窗口,再决定是否依赖。

不要围绕一个未公开的回调地址设计核心队列。

把轮询做成事件

落库任务 ID,每 3–5 秒查一次;到终态时只发一次内部事件,并用任务 ID 去重。这样应用层看到的就是「提交后等事件」,而不是到处写 sleep。

轮询 worker 和业务 worker 分开,任务完成后由业务 worker 取文件、转存、通知前端。

失败和超时不是一回事

接着看:轮询与超时 · Node.js 示例 · 并发与队列。

常见问题 / FAQ

能配置回调 URL 吗?

标准接入路径不能。用轮询,并在任务完成时发自己的内部事件。

轮询间隔多少合适?

3–5 秒。更密不会让歌更快生成,只会浪费限流额度。

worker 重启怎么办?

任务 ID 落库;重启后继续查这个 ID,不要重新提交。

申请 Key、第一个请求、接口清单与报错排查
注册只需要邮箱,一次生成 0.6 元出 2 首,MP3 与 WAV 下载不限次。
看轮询与超时设置