初始化音频文件

┌─────────────────────────────────────────────────────────────────┐
│ 第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

Request

Request Code Samples

Responses