Musik
Musik erstellen
Erstellt einen Task zur Musik-, Songtext- oder Sound-Generierung
Verwenden Sie GET /v1/models?recommended_for=music, um aktuelle Musikmodelle abzurufen.
Generieren Sie Musik, Songtexte und Sound mit KI. Dies ist eine asynchrone API. Erstellungsantworten geben eine Task-Identität zurück. Rufen Sie GET /v1/tasks/{id} damit per Polling auf, um den Status abzufragen.
Modelle unterscheiden sich in den Feldern, die sie akzeptieren. Überprüfen Sie GET /v1/models/{model}, bevor Sie optionale Felder senden; ein Feld, das das Modell nicht auflistet, kann 400 unsupported_parameter zurückgeben. Die Suno-Felder (mv, title, tags, negative_tags, audio_operation und die dazugehörigen Felder) gelten für Suno-Modelle. user wird nicht unterstützt und gibt 400 zurück.
Request-Body
suno-musicMusikmodell-ID, wie beispielsweise suno-music oder stable-audio-3. Übergeben Sie sie explizit. 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 Stem-Trennung.
Titel für den generierten Song.
Stil-Tags (z. B. „pop, upbeat, electronic“).
Zu vermeidende Stile. Erforderlich, wenn audio_operation den Wert add-instrumental hat.
Optionaler Wert MUSIC oder LYRICS. Wählen Sie ein Modell, das die entsprechende öffentliche Operation unterstützt; dieses Feld fügt einem reinen Musikmodell keine Songtext-Unterstützung hinzu.
Suno-Versionsauswahl. Erforderlich für Generierung, upload-cover, upload-extend, add-instrumental und Ersetzung aus audio_url. Lassen Sie es bei Songtexten, Ersetzung aus task_id + audio_id sowie Stem-Trennung weg. Zulässige Werte: chirp-v6, chirp-v6-mini, chirp-v6-wild.
Auf true setzen, um instrumentale Ausgaben ohne Gesang zu generieren.
Öffentlich erreichbare Referenz- oder hochgeladene Audio-URL. Wenn dies ohne audio_operation angegeben wird, verwendet TokenLab den Upload-Cover-Ablauf.
Audio-Operation: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.
vocal-separate, multi-stem-separation und advanced-split erfordern task_id + audio_id; advanced-split erfordert zudem stem_name. upload-extend erfordert continue_at größer als 0. add-instrumental erfordert audio_url, title, tags und negative_tags.
Senden Sie für replace-section 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 Ersetzungsintervall muss 6–60 Sekunden betragen.
Quell-Task-ID, die zu Ihrer Organisation gehört, für die Ersetzung von generiertem Audio oder Stem-Trennung.
Quell-Audio-ID, die im Ergebnis des Quell-Tasks zurückgegeben wurde. Erforderlich zusammen mit task_id für die Ersetzung von generiertem Audio und Stem-Trennung.
Ersetzungs-Startzeit in Sekunden, mindestens 0. Erforderlich für replace-section.
Ersetzungs-Endzeit in Sekunden. Erforderlich für replace-section; sie muss 6–60 Sekunden nach infill_start_s liegen.
Vollständiger Songtext für den resultierenden Song. Erforderlich für replace-section.
Stem-Name. Erforderlich für advanced-split.
ID eines vorherigen Clips, von dem aus fortgesetzt werden soll.
Zeit in Sekunden, ab der fortgesetzt werden soll. Erforderlich und größer als 0 für upload-extend.
Länge des generierten Audios in Sekunden, 1 bis 380. Nur für Modelle, die dies auflisten, wie beispielsweise stable-audio-3; die Details des Modells geben dessen eigenes Limit an.
Vom Modell aufgelistetes Audiodateiformat, zum Beispiel mp3, wav oder flac. Nur für Modelle, die dies auflisten.
Seed für reproduzierbare Ausgaben, 0 bis 4294967294. Nur für Modelle, die dies auflisten.
Anzahl der Generierungsschritte. Der Bereich hängt vom Modell ab (zum Beispiel 4 bis 8 für stable-audio-3). Nur für Modelle, die dies auflisten.
Einige Modelle führen weitere Felder auf, wie negative_prompt, n, seconds und guidance_scale. Senden Sie diese nur, wenn sie in den Details des Modells aufgeführt sind; ein Feld, das vom ausgewählten Modell nicht unterstützt wird, führt zu einem 400-Fehler.
Prompt-Führungsstärke, 1 bis 25. Nur für Modelle, die dies auflisten.
prompt akzeptiert bis zu 5000 Zeichen; tags und negative_tags akzeptieren jeweils bis zu 1000 Zeichen. Unterstützte Operationen und Parameter hängen von den aktuellen Details des ausgewählten Modells ab.
Antwort
Task-ID zum Abfragen des Status per Polling.
Alias derselben asynchronen Task-ID, sofern zurückgegeben.
Status-URL für diesen Task. Rufen Sie GET /v1/tasks/{id} mit id per Polling auf.
Task-Status: pending, processing, completed oder failed.
Erstellungszeitpunkt des Tasks als Unix-Zeitstempel, 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-v6",
"prompt": "An upbeat electronic dance track with heavy bass",
"title": "Night Drive",
"tags": "electronic, EDM, energetic"
}'Beispiel für eine Sound-Generierung für ein Modell, das duration und output_format anstelle der Suno-Felder akzeptiert:
{
"model": "stable-audio-3",
"prompt": "Warm lo-fi beat with soft vinyl crackle",
"duration": 30,
"output_format": "mp3"
}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"
Optionaler Schlüssel, der eine Erstellungsanfrage sicher für Wiederholungsversuche macht. Senden Sie für jede Aufgabe einen neuen eindeutigen Wert, wie z. B. eine UUID. Ein Wiederholungsversuch mit demselben Schlüssel und demselben Body gibt das Ergebnis der ursprünglichen Erstellungsanfrage zurück, in der Regel die ursprüngliche Aufgabe, und erstellt, versendet oder berechnet keine zweite Aufgabe. Ein abweichender Body mit einem bereits akzeptierten Schlüssel wird mit 409 abgelehnt. Ein Schlüssel mit mehr als 255 Zeichen wird ignoriert, und die Anfrage verfügt dann über keinen Idempotenz-Schutz. Siehe Sichere Wiederholungsversuche mit einem Idempotenz-Schlüssel.
1 <= length <= 255Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json
application/json
application/json