Passer au contenu principal
POST
Générer de la musique
Envoyez un model et un prompt à POST /v1/music/generate pour obtenir un morceau de n’importe quel fournisseur de musique avec une seule forme de requête. Phaseo gère pour vous les fournisseurs synchrones et l’interrogation des files d’attente des fournisseurs.

Lire le résultat

Une génération terminée contient audio_url ou audio_base64. status vaut queued, in_progress, completed ou failed. Tant que l’état n’est pas définitif, interrogez GET /v1/music/generate/{music_id} avec le même id. id est l’ID de requête Phaseo stable. nativeResponseId est l’identifiant du fournisseur d’origine, utile pour la corrélation avec le fournisseur et le support. usage contient output_audio_seconds lorsque le fournisseur indique la durée générée.

Définir les options Suno

Les modèles Suno acceptent un objet suno facultatif : prompt est obligatoire lorsque customMode vaut false, ainsi que lorsque customMode vaut true avec instrumental à false. Une requête qui enfreint une règle du fournisseur renvoie 400 :

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json
model
string
requis
models
string[]

Modèles de repli facultatifs et ordonnés, essayés après model. model est obligatoire et reste toujours le modèle principal. Lorsqu'une tentative échoue avec 429, 500, 502, 503 ou 504, l'entrée suivante est essayée ; les autres erreurs sont renvoyées telles quelles. Accepte jusqu'à 25 identifiants de modèle ou préréglages ; les doublons et les entrées identiques à model sont ignorés. Chaque tentative est validée, journalisée et facturée comme une requête distincte, et le champ model de la réponse ainsi que la trace de routage indiquent le modèle qui a servi la requête. Les requêtes en streaming ne basculent qu'avant le premier octet, et les tâches vidéo et musique uniquement lors de leur soumission. Les requêtes batch, realtime et council rejettent models. Les replis définis sur une route dynamique sont prioritaires, et phaseo/auto ne peut pas être combiné avec models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemple:
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 16 novembre 2026