API för att ladda upp källjud

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Att ladda upp källjud gör om en lokal eller fjärran ljudfil till ett källklipp som senare funktioner kan använda: cover, förlängning, ersätt avsnitt, separering med mera.

Ändpunkt: POST /api/music/upload-source

Fakturering: Kostnadsfritt. Den här ändpunkten laddar bara upp källjudet; den startar inget genereringsuppdrag.

Rekommenderad användning: det här är steg 1 i "cover i två steg". Ladda upp ljudet med den här ändpunkten först (kostnadsfritt, och du kan försöka igen när det misslyckas) och spara den returnerade clip_id; när du har bekräftat att uppladdningen lyckades (status i ett slutfört läge), anropa API för cover från ett källklipp för att starta covern — den begärans body är bara några hundra byte, så den kan inte trunkeras under överföringen för att ljudet är för stort. Jämfört med engångs-API:t ladda upp och gör cover är den här uppdelningen robustare när ljudet är stort, nätet är instabilt eller samma material ska återanvändas flera gånger (förlängning / ersättning / separering).

Tips för stora filuppladdningar

När uppladdningen är klar, bekräfta alltid att status i svaret redan är slutfört och spara clip_id innan du går vidare till steg 2; en misslyckad uppladdning debiteras inte och skapar inget genereringsuppdrag — försök bara igen.

Begäransparametrar

Headers

För JSON-begäranden:

Sätt inte Content-Type manuellt i multipart-begäranden; klienten skapar den automatiskt.

Body-parametrar

JSON-exempelbegäran

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

multipart-exempelbegäran

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"

Svar

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