Skip to main content
POST
Generar música
Genera música con una API independiente del proveedor. Phaseo gestiona las respuestas síncronas y consulta en segundo plano las colas de los proveedores. Cuando la generación termina, la respuesta incluye audio_url o audio_base64. Si un proveedor devuelve un trabajo aún activo, usa el mismo id de la respuesta con GET /music/generate/{music_id}.

Estructura de la solicitud

Opciones de Suno

  • suno.customMode (booleano; predeterminado: false)
  • suno.instrumental (booleano; predeterminado: false)
  • suno.prompt (anulación opcional de prompt en el nivel superior)
  • suno.style, suno.title (obligatorio cuando customMode = true)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

Reglas de validación

  • Cuando customMode = false, se requiere prompt.
  • Cuando customMode = true, se requieren style y title.
  • Cuando customMode = true e instrumental = false, se requiere prompt.
Los errores de validación devuelven 400 con:

Respuesta

  • id es el identificador de solicitud estable de Phaseo. Úsalo para recuperar la solicitud mediante GET /music/generate/{music_id}.
  • nativeResponseId es el identificador del proveedor ascendente; sirve para correlacionar solicitudes y contactar con su equipo de soporte.
  • status puede ser queued, in_progress, completed o failed.
  • usage puede incluir output_audio_seconds cuando el proveedor informa de la duración generada.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

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

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

Controles de depuración de la pasarela. Estas opciones nunca se reenvían al proveedor.

Respuesta

200 - application/json

Respuesta de generación de música

id
string
requerido

ID de solicitud estable de Phaseo, que se utiliza con GET /music/generate/{music_id}.

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

Identificador del proveedor de origen para correlación y asistencia.

audio_url
string<uri>
audio_base64
string
result
any

Metadatos del resultado del proveedor normalizados por Phaseo.

output
object[]
usage
object
Última modificación el 2 de octubre de 2026