/v2/generateGenerar 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.
https://udioapi.pro/api/v2/generatetips
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 |
|---|---|---|
nameAuthorization | requiredyes | descriptionToken de portador para autenticación |
nameContent-Type | requiredyes | descriptionapplication/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 |
|---|---|---|---|---|
paramNamegpt_description_prompt | paramTypestring | requiredyes | descriptionDescripción de texto de la música que deseas generar. | exampleA 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 |
|---|---|---|---|---|
paramNameprompt | paramTypestring | requiredyes | descriptionLetras personalizadas o mensaje detallado | exampleVerse 1: Walking down the street, feeling so free... |
paramNamestyle | paramTypestring | requiredno | descriptionEstilo o género musical | examplepop, upbeat, electronic, 120 bpm |
paramNametitle | paramTypestring | requiredno | descriptionTítulo de la canción | exampleSummer Dreams |
paramNametags | paramTypestring | requiredno | descriptionEtiquetas negativas a evitar | examplesad, slow |
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
paramNamemodel | paramTypestring | requiredno | descriptionModelo de IA a utilizar. | examplechirp-v5-5 |
paramNamemake_instrumental | paramTypeboolean | requiredno | descriptionGenera música instrumental sin voces. | examplefalse |
paramNamegender | paramTypestring | requiredno | descriptionPreferencia de género vocal | examplefemale |
paramNamestyle_weight | paramTypenumber | requiredno | descriptionFuerza de adherencia al estilo. | example0.65 |
paramNameweirdness_constraint | paramTypenumber | requiredno | descriptionControla la desviación creativa | example0.65 |
paramNameaudio_weight | paramTypenumber | requiredno | descriptionEquilibrio de peso para funciones de audio | example0.65 |
responses
{
"code": 200,
"message": "success",
"workId": "gen2abc123def456bksv",
"data": {
"task_id": "gen2abc123def456bksv"
}
}codeExamples
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
}'