Saltar al contenido principal
POST
Generar música
Envía un model y un prompt a POST /v1/music/generate para obtener una pista de cualquier proveedor de música con una única forma de solicitud. Phaseo se encarga de los proveedores síncronos y de consultar las colas de los proveedores por ti.

Lee el resultado

Una generación completada incluye audio_url o audio_base64. status es queued, in_progress, completed o failed. Si aún no es definitivo, consulta GET /v1/music/generate/{music_id} con el mismo id. id es el ID de solicitud estable de Phaseo. nativeResponseId es el identificador del proveedor, para correlacionar con el proveedor y para soporte. usage incluye output_audio_seconds cuando el proveedor informa de la duración generada.

Configura las opciones de Suno

Los modelos de Suno aceptan un objeto suno opcional: prompt es obligatorio cuando customMode es false, y cuando customMode es true con instrumental en false. Una solicitud que incumple una regla del proveedor devuelve 400:

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
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 16 de noviembre de 2026