POST/v2/generate

Generar API de música

Música predeterminada Generar punto final para la creación de música con IA. Admite tanto el modo de inspiración como el modo personalizado.

POSThttps://udioapi.pro/api/v2/generate

tips

Punto final predeterminado: use /v2/generate para la generación estándar.

Modos: el modo de inspiración usa gpt_description_prompt; el modo personalizado utiliza prompt, style, title.

Selección de modelo: elige chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 o chirp-v5-5. Consulta la descripción de modelos y el consumo de créditos.

Siguiente paso: después de llamar a este endpoint, use la API de estado de tarea de generación de música para consultar el progreso y obtener URLs de audio.

requestHeaders

name	required	description
`Authorization`	yes	Token de portador para autenticación
`Content-Type`	yes	application/json

requestBody

El cuerpo de la solicitud admite el modo de inspiración o el modo personalizado

Modo de inspiración

Generar música a partir de una descripción de texto.

paramName	paramType	required	description	example
`gpt_description_prompt`	`string`	yes	Descripción de texto de la música que deseas generar.	`A upbeat pop song about summer vacation with catchy melody`

Modo personalizado

Genera música con letras, estilos y títulos personalizados

paramName	paramType	required	description	example
`prompt`	`string`	yes	Letras personalizadas o mensaje detallado	`Verse 1: Walking down the street, feeling so free...`
`style`	`string`	no	Estilo o género musical	`pop, upbeat, electronic, 120 bpm`
`title`	`string`	no	Título de la canción	`Summer Dreams`
`tags`	`string`	no	Etiquetas negativas a evitar	`sad, slow`

commonParams

paramName	paramType	required	description	example
`model`	`string`	no	Modelo de IA a utilizar.	`chirp-v5-5`
`make_instrumental`	`boolean`	no	Genera música instrumental sin voces.	`false`
`gender`	`string`	no	Preferencia de género vocal	`female`
`style_weight`	`number`	no	Fuerza de adherencia al estilo.	`0.65`
`weirdness_constraint`	`number`	no	Controla la desviación creativa	`0.65`
`audio_weight`	`number`	no	Equilibrio de peso para funciones de audio	`0.65`

responses

json

{
  "code": 200,
  "message": "success",
  "workId": "gen2abc123def456bksv",
  "data": {
    "task_id": "gen2abc123def456bksv"
  }
}

codeExamples

curl

curl -X POST "https://udioapi.pro/api/v2/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v4-5",
    "prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
    "style": "pop, upbeat, electronic, 120 bpm",
    "title": "Summer Dreams",
    "make_instrumental": false,
    "gender": "female",
    "style_weight": 0.65,
    "weirdness_constraint": 0.65,
    "audio_weight": 0.65
  }'