Zum Hauptinhalt springen
POST
Musik erzeugen
Sende model und prompt an POST /v1/music/generate, um mit einer einzigen Anfrageform einen Track von jedem Musikanbieter zu erhalten. Phaseo kümmert sich für dich um synchrone Anbieter und das Abfragen von Anbieterwarteschlangen.

Das Ergebnis lesen

Eine abgeschlossene Generierung enthält audio_url oder audio_base64. status ist queued, in_progress, completed oder failed. Ist der Status noch nicht endgültig, frage GET /v1/music/generate/{music_id} mit derselben id ab. id ist die stabile Phaseo-Anfrage-ID. nativeResponseId ist die Kennung des Upstream-Anbieters, zur Zuordnung beim Anbieter und für den Support. usage enthält output_audio_seconds, wenn der Anbieter die generierte Dauer meldet.

Suno-Optionen festlegen

Suno-Modelle nehmen ein optionales suno-Objekt: prompt ist Pflicht, wenn customMode gleich false ist, und wenn customMode gleich true ist und instrumental auf false steht. Eine Anfrage, die gegen eine Anbieterregel verstößt, gibt 400 zurück:

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
models
string[]

Optionale, geordnete Fallback-Modelle, die nach model versucht werden. model ist erforderlich und immer das primäre Modell. Schlägt ein Versuch mit 429, 500, 502, 503 oder 504 fehl, wird der nächste Eintrag versucht; andere Fehler werden unverändert zurückgegeben. Akzeptiert bis zu 25 Modell-IDs oder Presets; Duplikate und Einträge, die model entsprechen, werden ignoriert. Jeder Versuch wird als eigene Anfrage validiert, protokolliert und abgerechnet, und das Feld model der Antwort sowie der Routing-Trace zeigen das Modell, das die Anfrage bedient hat. Streaming-Anfragen weichen nur vor dem ersten Byte aus, Video- und Musikjobs nur bei der Übermittlung. Batch-, Realtime- und Council-Anfragen lehnen models ab. Auf einer dynamischen Route festgelegte Fallbacks haben Vorrang, und phaseo/auto kann nicht mit models kombiniert werden.

Required array length: 1 - 25 elements
Minimum string length: 1
Beispiel:
prompt
string
duration
integer
format
enum<string>
Verfügbare Optionen:
mp3,
wav,
ogg,
aac
provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

Gateway-Debug-Steuerungen. Diese Flags werden niemals an den Anbieter weitergeleitet.

Antwort

200 - application/json

Antwort zur Musikgenerierung

id
string
erforderlich

Stabile Phaseo-Anfrage-ID für die Verwendung mit GET /music/generate/{music_id}.

object
enum<string>
erforderlich
Verfügbare Optionen:
music
status
enum<string>
erforderlich
Verfügbare Optionen:
queued,
in_progress,
completed,
failed
model
string
erforderlich
provider
string
erforderlich
nativeResponseId
string | null

Upstream-Anbieterkennung für Korrelation und Support.

audio_url
string<uri>
audio_base64
string
result
any

Von Phaseo normalisierte Metadaten des Anbieterergebnisses.

output
object[]
usage
object
Zuletzt geändert am 16. November 2026