Query upload processing status

┌─────────────────────────────────────────────────────────────────┐
Step 1: Request Upload Authorization
│ POST /suno/uploads/audio │
│ ↓ Returns: upload_id, upload_url │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
Step 2: Upload files to S3 (direct client connection, without API)
│ PUT {upload_url} │
Upload audio file │ ↓
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
Step 3: Report uploaded successfully.
│ POST /suno/uploads/audio/{id}/upload-finish │
│ ↓ Notification server that file has been uploaded │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
Step 4: Poll the upload status (until the status is "completed")
│ GET /suno/uploads/audio/{id} │
│ ↓ Query every 2-3 seconds │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
Step 5: Initialize the audio clip
│ POST /suno/uploads/audio/{id}/initialize-clip │
│ ↓ Returns: clip_id │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
Step 6: Create a continuation task using clip_id |
│ POST /suno/submit/music │
│ ↓ Returns: task_id (Billing Started) │
└─────────────────────────────────────────────────────────────────┘

Responses

🟢200success

application/json

Bodyapplication/json

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

Query upload processing status

Request

Request Code Samples

Responses