Query Upload Processing Status

GET https://www.kkiai.com/suno/uploads/audio/{id}

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

Authorization

Add the Authorization parameter in the Header, with the value being the Token concatenated after Bearer

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

Path Parameters

Parameter	Type	Required	Description
id	string	Required

Request Example

{}

Response

🟢 200 Success

Response Body

Parameter	Type	Required	Description
id	string	Required
status	string	Required
error_message	null	Required
s3_id	string	Required
title	string	Required
image_url	string	Required

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