Musik
Musik erstellen
Erstellt eine Musikgenerierungsaufgabe mit Suno
Generieren Sie Musik und Songtexte mithilfe von KI. Dies ist eine asynchrone API. Die Create-Response gibt eine Task-ID zurück und kann, wenn verfügbar, auch eine bevorzugte poll_url enthalten.
Anfrage-Body
suno_musicMusikmodell-ID, etwa suno-music. Wählen Sie für reine Songtexte ein Modell, dessen aktuelle öffentliche Operationen lyrics enthalten.
Musikbeschreibung oder Ersatztext. Erforderlich für Musik, Songtexte, upload-cover, upload-extend und replace-section; optional für add-instrumental und Spurentrennung.
Titel für den generierten Song.
Stil-Tags (z. B. „pop, upbeat, electronic“).
Zu vermeidende Stile. Erforderlich, wenn audio_operation add-instrumental ist.
Optional MUSIC oder LYRICS. Wählen Sie ein Modell mit der passenden öffentlichen Operation; dieses Feld erweitert ein reines Musikmodell nicht um Songtextgenerierung.
Suno-Versionsauswahl. Erforderlich für Generierung, upload-cover, upload-extend, add-instrumental und Ersetzung aus audio_url. Bei Songtexten, Ersetzung aus task_id + audio_id und Spurentrennung weglassen. Zulässige Werte: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
Auf true setzen, um ein instrumentales Ergebnis ohne Gesang zu erzeugen.
Öffentlich erreichbare Referenz- oder Upload-Audio-URL. Ohne audio_operation verwendet TokenLab den upload-cover-Flow.
Audiooperation: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation und advanced-split benötigen task_id + audio_id; advanced-split zusätzlich stem_name. upload-extend benötigt continue_at größer als 0. add-instrumental benötigt audio_url, title, tags und negative_tags.
replace-section benötigt prompt, tags, title, infill_start_s, infill_end_s und full_lyrics. Wählen Sie genau eine Quelle: task_id + audio_id oder audio_url + mv. Das Ersatzintervall muss 6–60 Sekunden betragen.
Quellaufgaben-ID Ihrer Organisation für die Ersetzung generierten Audios oder die Spurentrennung.
Audio-ID aus dem Ergebnis der Quellaufgabe. Für die Ersetzung generierten Audios und die Spurentrennung zusammen mit task_id erforderlich.
Beginn der Ersetzung in Sekunden, mindestens 0. Für replace-section erforderlich.
Ende der Ersetzung in Sekunden. Für replace-section erforderlich und 6–60 Sekunden nach infill_start_s.
Vollständiger Songtext des resultierenden Songs. Für replace-section erforderlich.
Name der Tonspur. Für advanced-split erforderlich.
ID eines vorherigen Clips, an dem fortgesetzt werden soll.
Zeitpunkt in Sekunden für die Fortsetzung. Für upload-extend erforderlich und größer als 0.
prompt erlaubt bis zu 5000 Zeichen; tags und negative_tags jeweils bis zu 1000. Unterstützte Operationen und Parameter richten sich nach den aktuellen Modelldetails.
Antwort
Task-ID für die Statusabfrage.
Alias derselben asynchronen Aufgaben-ID, sofern zurückgegeben.
Bevorzugte Polling-URL, wenn verfügbar.
Task-Status: pending, processing, completed oder failed.
Unix-Zeitstempel der Aufgabenerstellung, sofern zurückgegeben.
Anfrage
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"mv": "chirp-v4",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Antwort
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.
Zulässige Werte
- "auto"
- "verified"
- "official"
Anfragekörper
application/json
Antwort
application/json
application/json