Запрос разрешения на загрузку
Developing
┌─────────────────────────────────────────────────────────────────┐
│ Шаг 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 (начало тарификации) │
└─────────────────────────────────────────────────────────────────┘
Request
Provide your bearer token in the Authorization
header when making requests to protected resources. Example:Authorization: Bearer ********************
Body Params application/json
Request Code Samples
curl --location 'https://stackapi.ai/suno/uploads/audio' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"extension": "mp3"
}'
Responses
application/json
{
"id": "f208ab1f-e93a-4417-b089-e7fc38b50268",
"url": "https://suno-uploads.s3.amazonaws.com/",
"fields": {
"Content-Type": "audio/mpeg",
"key": "raw_uploads/f208ab1f-e93a-4417-b089-e7fc38b50268.mp3",
"AWSAccessKeyId": "AKIA2V4GXGDKLZ43MUG7",
"policy": "eyJleHBpcmF0aW9uIjogIjIwMjYtMDEtMDZUMDM6Mjg6MjlaIiwgImNvbmRpdGlvbnMiOiBbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDUyNDI4ODAwMF0sIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJhdWRpby9tcGVnIl0sIHsiYnVja2V0IjogInN1bm8tdXBsb2FkcyJ9LCB7ImtleSI6ICJyYXdfdXBsb2Fkcy9mMjA4YWIxZi1lOTNhLTQ0MTctYjA4OS1lN2ZjMzhiNTAyNjgubXAzIn1dfQ==",
"signature": "tevxOl3SW28afyLyzObeCYzIvWI="
},
"is_file_uploaded": false
}
Modified at 2026-06-15 10:10:18