Suno API 的 Java 调用示例

准备

Java 11+、Jackson（解析 JSON）、一个放在环境变量里的 Key。请求头统一用 Authorization: Bearer <KEY>。生成类接口按次计费，查询与取地址免费。

提交与轮询

var client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(30)).build();
var mapper = new ObjectMapper();
var key = System.getenv("SUNO_API_KEY");

var create = HttpRequest.newBuilder(URI.create(BASE + "/api/music/create"))
    .timeout(Duration.ofMinutes(5))
    .header("Authorization", "Bearer " + key)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(
        "{\"description\":\"city pop, 90s, female vocal\",\"model\":\"suno-v6\"}"))
    .build();
var body = client.send(create, HttpResponse.BodyHandlers.ofString()).body();
var songId = mapper.readTree(body).path("data").path("clips").get(0)
    .path("song_id").asText();

轮询时把客户端超时设到分钟级；超时只代表没等到响应，先查同一个任务，不要立刻重提。

取地址与下载

完成后调用 POST /api/music/download-url，传 { song_id, kind: "song" }。地址是临时的：要长期保存就把文件下载到自己的对象存储，数据库里存任务 ID，而不是存 URL。

429 用指数退避（1s → 2s → 4s），并降低并发；不要用固定 1 秒无限重试。