Initialize audio file
Developing
POST
/suno/uploads/audio/{id}/initialize-clip
│ Step 1: Request upload authorization │
│ POST /suno/uploads/audio │
│ ↓ Returns: upload_id, upload_url │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Step 2: Upload file to S3 (direct client connection, not │
│ through API) │
│ PUT {upload_url} │
│ ↓ Upload audio file │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Step 3: Report upload completion │
│ POST /suno/uploads/audio/{id}/upload-finish │
│ ↓ Notify server that file has been uploaded │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Step 4: Poll upload status (until status is completed) │
│ GET /suno/uploads/audio/{id} │
│ ↓ Query every 2-3 seconds │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Step 5: Initialize audio clip │
│ POST /suno/uploads/audio/{id}/initialize-clip │
│ ↓ Returns: clip_id │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ Step 6: Create continuation task using clip_id │
│ POST /suno/submit/music │
│ ↓ Returns: task_id (billing starts) │
└───────────────────────── ────────────────────────────────────────┘
Request
Path Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/suno/uploads/audio//initialize-clip' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{}'Response Response Example
{
"clip_id": "05c9b477-4519-4810-9ffa-00580c082067"
}Modified at 2026-03-06 15:34:51