查询上传处理状态

开发中 GET https://aiapi.winfull.top/suno/uploads/audio/{id} ┌─────────────────────────────────────────────────────────────────┐
│ 第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 (开始计费) │
└─────────────────────────────────────────────────────────────────┘

请求参数

Authorization 在 Header 添加参数 Authorization ，其值为在 Bearer 之后拼接 Token 示例： Authorization: Bearer ******************** Path 参数 生成代码 Body 参数application/json必填 生成代码 示例

{}

请求示例代码

Shell JavaScript Java Swift Go PHP Python HTTP C C# Objective-C Ruby OCaml Dart R 请求示例请求示例 Shell JavaScript Java Swift cURLcURL-WindowsHttpiewgetPowerShell

curl --location --request GET 'https://aiapi.winfull.top/suno/uploads/audio/e9451fca-e267-4e7f-b23e-c7419aa79cab' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功 application/json生成代码 Body 生成代码 示例

{
    "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"
}

修改于 2026-01-08 05:24:28