Musik

Musik erstellen

Erstellt einen Task zur Musik-, Songtext- oder Sound-Generierung

POST
/v1/music/generations

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

modelstringStandard: suno-music

Musikmodell-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.

promptstring

Musikbeschreibung oder Ersatztext. Erforderlich für Musik, Songtexte, upload-cover, upload-extend und replace-section; optional für add-instrumental und Stem-Trennung.

titlestring

Titel für den generierten Song.

tagsstring

Stil-Tags (z. B. „pop, upbeat, electronic“).

negative_tagsstring

Zu vermeidende Stile. Erforderlich, wenn audio_operation den Wert add-instrumental hat.

actionstring

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.

mvstring

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.

make_instrumentalboolean

Auf true setzen, um instrumentale Ausgaben ohne Gesang zu generieren.

audio_urlstring

Öffentlich erreichbare Referenz- oder hochgeladene Audio-URL. Wenn dies ohne audio_operation angegeben wird, verwendet TokenLab den Upload-Cover-Ablauf.

audio_operationstring

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.

task_idstring

Quell-Task-ID, die zu Ihrer Organisation gehört, für die Ersetzung von generiertem Audio oder Stem-Trennung.

audio_idstring

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.

infill_start_snumber

Ersetzungs-Startzeit in Sekunden, mindestens 0. Erforderlich für replace-section.

infill_end_snumber

Ersetzungs-Endzeit in Sekunden. Erforderlich für replace-section; sie muss 6–60 Sekunden nach infill_start_s liegen.

full_lyricsstring

Vollständiger Songtext für den resultierenden Song. Erforderlich für replace-section.

stem_namestring

Stem-Name. Erforderlich für advanced-split.

continue_clip_idstring

ID eines vorherigen Clips, von dem aus fortgesetzt werden soll.

continue_atnumber

Zeit in Sekunden, ab der fortgesetzt werden soll. Erforderlich und größer als 0 für upload-extend.

durationinteger

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.

output_formatstring

Vom Modell aufgelistetes Audiodateiformat, zum Beispiel mp3, wav oder flac. Nur für Modelle, die dies auflisten.

seedinteger

Seed für reproduzierbare Ausgaben, 0 bis 4294967294. Nur für Modelle, die dies auflisten.

stepsinteger

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.

cfg_scalenumber

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

idstring

Task-ID zum Abfragen des Status per Polling.

task_idstring

Alias derselben asynchronen Task-ID, sofern zurückgegeben.

poll_urlstring

Status-URL für diesen Task. Rufen Sie GET /v1/tasks/{id} mit id per Polling auf.

statusstring

Task-Status: pending, processing, completed oder failed.

createdinteger

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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "suno-music"
}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Länge1 <= length <= 255

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json

application/json

application/json