Sample-API

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

Beskrivning av ändpunkten

Sampling tar ett stycke material från en befintlig låt och skapar en ny låt utifrån det. För närvarande är det läge som är öppet för kunder sampleläget chop.

Ändpunkt: POST /api/music/sample

Fakturering: Betalt, debiteras enligt den begärda modellen; det faktiskt debiterade beloppet följer prisinställningen i backoffice.

Max Mode / Variety: den här ändpunkten stöder de valfria parametrarna max_mode och variety (0-4). Med max_mode på debiteras anropet till dubbelt pris; variety kostar inget extra. Vad de betyder och hur de skickas står i avsnittet "Avancerade parametrar" i Översikt över det nya API:t.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till generering först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, och försök inte igen direkt efter en timeout (det duplicerar beställningen och debiterar igen). Om anslutningen bröts, kontrollera senare med GET /api/music/songs. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Autentisering

Begäransparametrar

Exempelbegäran

curl -X POST https://www.suno-api.io/api/music/sample \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "mode": "chop",
    "start_seconds": 0,
    "end_seconds": 30,
    "style_tags": "funky pop, chopped sample",
    "song_title": "Sample-version",
    "wait_completion": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Sample-version",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Sample-version",
        "status": "pending"
      }
    ]
  }
}

Ett anrop ger 2 resultat (debiteras som 2 låtar); exemplet visar 2. Utgå från längden på clips-arrayen och använd inte ett fast antal iterationer. Spara clips[].song_id och fråga API för låtfrågor och historik tills statusen är completed.

Noter

• För närvarande är endast läget chop öppet.
• as-is, as_is, asis och blend returnerar för närvarande HTTP 400 och skickar inget genereringsuppdrag.
• start_seconds måste vara 0 eller större och mindre än end_seconds.