Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

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

​
model
string
Standard:"suno_music"
Zu verwendendes Modell: suno_music für die Musikgenerierung, suno_lyrics nur für Songtexte.
​
prompt
string
erforderlich
Beschreibung der zu generierenden Musik. Kann Stil, Stimmung, Instrumente usw. enthalten.
​
title
string
Titel für den generierten Song.
​
tags
string
Stil-Tags (z. B. „pop, upbeat, electronic“).
​
action
string
Generierungstyp: MUSIC (Standard) oder LYRICS.
​
mv
string
Zu verwendende Modellversion.
​
continue_clip_id
string
ID eines vorherigen Clips, an dem fortgesetzt werden soll.
​
continue_at
number
Zeitstempel (in Sekunden), ab dem fortgesetzt werden soll.
​
user
string
Eine eindeutige Kennung für den Endbenutzer.

​
Antwort

​
id
string
Task-ID für die Statusabfrage.
​
task_id
string
Alias der asynchronen Task-ID, wenn vom Adapter zurückgegeben.
​
poll_url
string
Bevorzugte Polling-URL, wenn verfügbar.
​
status
string
Task-Status: pending, processing, completed oder failed.
​
created
integer
Unix-Zeitstempel der Task-Erstellung.
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",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}