Suno 查询上传处理状态

Suno 查询上传处理状态 官方接口参考文档：https://docs.sunoapi.org

┌─────────────────────────────────────────────────────────────────┐
│ 第 1 步: 请求上传授权 │
│ POST /suno/uploads/audio │
│ ↓ 返回: upload_id, upload_url │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 第 2 步: 上传文件到 S3（客户端直连，不经过 API） │
│ PUT {upload_url} │
│ ↓ 上传音频文件 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 第 3 步: 报告上传完毕 │
│ POST /suno/uploads/audio/{id}/upload-finish │
│ ↓ 通知服务器文件已上传 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 第 4 步: 轮询查询上传状态（直到状态为 completed） │
│ GET /suno/uploads/audio/{id} │
│ ↓ 每 2 到 3 秒查询一次 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 第 5 步: 初始化音频 clip │
│ POST /suno/uploads/audio/{id}/initialize-clip │
│ ↓ 返回: clip_id │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 第 6 步: 使用 clip_id 创建续写任务 │
│ POST /suno/submit/music │
│ ↓ 返回: task_id（开始计费） │
└─────────────────────────────────────────────────────────────────┘

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

Example

{
    "id": "c25a8c59-000a-481f-ac28-efde2dc9e677",
    "status": "complete",
    "error_message": null,
    "s3_id": "m_05c9b477-4519-4810-9ffa-00580c082067",
    "title": "S-100096-100096-84069F8B",
    "image_url": "https://cdn1.suno.ai/image_05c9b477-4519-4810-9ffa-00580c082067.png"
}