Skip to main content
POST
Quellaudio-Referenz: Für Vorgänge auf Basis vorhandener Songs sind keine zusätzlichen IDs erforderlich. Übergeben Sie die task_id der Aufgabe, die die Quellspur erzeugt hat, sowie audio_index für die Position in data.result.music[] (ab 1, Standard 1).
Dieser Endpunkt hat keine Versionsdimension: Übergeben Sie version nicht — wird es übergeben, wird es verworfen und beeinflusst die Abrechnung nicht.

Authorizations

string
erforderlich
Alle Schnittstellen erfordern eine Authentifizierung mit einem Bearer TokenAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie bei der Verwendung im Request-Header hinzu:

Body

string
Standard:"suno"
Audiomodell. Übergeben Sie derzeit suno (ohne Angabe standardmäßig suno).
string
erforderlich
Die task_id der Aufgabe, die den Quell-Audiotrack erzeugt hat. Fehlt sie oder kann die Quelle nicht aufgelöst werden, wird zum Zeitpunkt des Absendens ein 400 zurückgegeben.
integer
Standard:"1"
Wählt eine Spur aus data.result.music[] der Quellaufgabe aus (ab 1; Standard 1).
string
erforderlich
Persona-Name; fehlt er, wird sofort 400 zurückgegeben.
string
Beschreibung.
string
Stil.
number
Startpunkt des Stimmclips in Sekunden, mindestens 0. Die gemeinsame Verwendung mit vocal_end_s wird empfohlen.
number
Endpunkt des Stimmclips in Sekunden. Muss nach dem Startpunkt liegen und darf die bekannte Quelldauer nicht überschreiten.
Lesen Sie nach Abschluss result.persona_id. Die Persona-ID unterscheidet sich von der benutzerdefinierten Modell-ID und darf nicht als API-Wert für model verwendet werden. Im neuen Ablauf muss Vox nicht zuvor erstellt werden.
Ergebnis abrufen: Fragen Sie die asynchrone Aufgabe bis zum Abschluss ab. Das Ergebnis enthält die Persona-Informationen. Bei einem Fehler wird der abgezogene Betrag automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array