Skip to main content
POST
Générer de la musique
Générez de la musique avec une API indépendante des fournisseurs. Phaseo gère les réponses synchrones et interroge les files des fournisseurs en arrière-plan. Une fois la génération terminée, la réponse inclut audio_url ou audio_base64. Si un fournisseur renvoie une tâche non terminée, utilisez le même id de réponse avec GET /music/generate/{music_id}.

Structure de la requête

Options Suno

  • suno.customMode (booléen, valeur par défaut : false)
  • suno.instrumental (booléen, valeur par défaut : false)
  • suno.prompt (remplacement facultatif de prompt au niveau supérieur)
  • suno.style, suno.title (obligatoire lorsque customMode = true)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

Règles de validation

  • Lorsque customMode = false, prompt est obligatoire.
  • Lorsque customMode = true, style et title sont tous deux obligatoires.
  • Lorsque customMode = true et instrumental = false, prompt est obligatoire.
Les erreurs de validation renvoient 400 avec :

Réponse

  • Le champ id est la clé stable de requête Phaseo. Utilisez-le pour récupérer la requête via GET /music/generate/{music_id}.
  • La valeur de nativeResponseId correspond au fournisseur en amont et permet de retrouver sa requête et de contacter son assistance.
  • status peut être queued, in_progress, completed ou failed.
  • usage peut inclure output_audio_seconds lorsque le fournisseur indique la durée générée.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json
model
string
requis
prompt
string
duration
integer
format
enum<string>
Options disponibles:
mp3,
wav,
ogg,
aac
provider
object

Préférences de routage des fournisseurs pour la sélection par la passerelle.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

Options de débogage de la passerelle. Ces indicateurs ne sont jamais transmis au fournisseur.

Réponse

200 - application/json

Réponse de génération musicale

id
string
requis

ID de requête Phaseo stable à utiliser avec GET /music/generate/{music_id}.

object
enum<string>
requis
Options disponibles:
music
status
enum<string>
requis
Options disponibles:
queued,
in_progress,
completed,
failed
model
string
requis
provider
string
requis
nativeResponseId
string | null

Identifiant du fournisseur amont pour la corrélation et l’assistance.

audio_url
string<uri>
audio_base64
string
result
any

Métadonnées du résultat fournisseur normalisées par Phaseo.

output
object[]
usage
object
Dernière modification le 2 octobre 2026