Skip to main content
POST
Musik erzeugen
Musik lässt sich über eine anbieterunabhängige API erzeugen. Phaseo verarbeitet synchrone Antworten und fragt Anbieterwarteschlangen im Hintergrund ab. Nach Abschluss enthält die Antwort audio_url oder audio_base64. Gibt ein Anbieter einen noch nicht abgeschlossenen Auftrag zurück, verwende dieselbe Antwort-id mit GET /music/generate/{music_id}.

Aufbau der Anfrage

Suno-Optionen

  • suno.customMode (boolesch, Standard: false)
  • suno.instrumental (boolesch, Standard: false)
  • suno.prompt (optionale Überschreibung von prompt auf oberster Ebene)
  • suno.style, suno.title (erforderlich, wenn customMode = true ist)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

Validierungsregeln

  • Wenn customMode = false ist, ist prompt erforderlich.
  • Wenn customMode = true ist, sind style und title erforderlich.
  • Wenn customMode = true und instrumental = false sind, ist prompt erforderlich.
Validierungsfehler geben 400 zurück mit:

Antwort

  • id ist die stabile Phaseo-Anfrage-ID. Verwenden Sie sie, um die Anfrage über GET /music/generate/{music_id} abzurufen.
  • nativeResponseId ist die Kennung des vorgelagerten Anbieters und dient der Zuordnung beim Anbieter sowie für Supportanfragen.
  • status kann queued, in_progress, completed oder failed sein.
  • usage kann output_audio_seconds enthalten, wenn der Anbieter die erzeugte Dauer meldet.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
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 2. Oktober 2026