API di caricamento dell'audio di origine

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

Il caricamento dell'audio di origine trasforma un file audio locale o remoto in un clip di origine che le funzioni successive possono usare: cover, estensione, sostituzione di sezione, separazione e altre.

Endpoint: POST /api/music/upload-source

Fatturazione: Gratuito. Questo endpoint carica solo l'audio di origine; non avvia alcuna attività di generazione.

Uso consigliato: è il passo 1 del «cover in due passi». Carica prima l'audio con questo endpoint (è gratuito e puoi riprovare ogni volta che fallisce) e conserva il clip_id restituito; dopo aver confermato che il caricamento è riuscito (status in stato completato), chiama l'API di cover da un clip di origine per avviare il cover — il corpo di quella richiesta è di poche centinaia di byte, quindi non può essere troncato in transito perché l'audio è troppo grande. Rispetto all'API in un solo passaggio carica e fai il cover, questa separazione è più robusta quando l'audio è grande, la rete è instabile o lo stesso materiale va riutilizzato più volte (estensione / sostituzione / separazione).

Consigli per il caricamento di file grandi

Al termine del caricamento conferma sempre che lo status nella risposta sia già completato e conserva il clip_id prima di passare al passo 2; un caricamento fallito non viene addebitato e non crea alcuna attività di generazione, basta riprovare.

Parametri della richiesta

Headers

Per le richieste JSON:

Non impostare Content-Type manualmente nelle richieste multipart; lo genera il client.

Parametri del corpo

Esempio di richiesta JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

Esempio di richiesta multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

Risposta

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}