POST/v2/generate

Gerar API de música

Endpoint de geração de música padrão para criação de música com IA. Suporta modo de inspiração e modo personalizado.

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

tips

Endpoint padrão: Use /v2/generate para geração padrão.

Modos: O modo de inspiração usa gpt_description_prompt; o modo personalizado usa prompt, style, title.

Seleção de modelo: escolha chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 ou chirp-v5-5. Veja a descrição dos modelos e o consumo de créditos.

Próximo passo: após chamar este endpoint, use a API de status de tarefa de geração de música para consultar o progresso e obter URLs de áudio.

requestHeaders

name	required	description
`Authorization`	yes	Token de portador para autenticação
`Content-Type`	yes	application/json

requestBody

O corpo da solicitação suporta o modo Inspiration ou o modo personalizado

Modo de inspiração

Gere música a partir de uma descrição de texto

paramName	paramType	required	description	example
`gpt_description_prompt`	`string`	yes	Descrição de texto da música que você deseja gerar	`A upbeat pop song about summer vacation with catchy melody`

Modo personalizado

Gere músicas com letras, estilo e título personalizados

paramName	paramType	required	description	example
`prompt`	`string`	yes	Letras personalizadas ou prompt detalhado	`Verse 1: Walking down the street, feeling so free...`
`style`	`string`	no	Estilo ou gênero musical	`pop, upbeat, electronic, 120 bpm`
`title`	`string`	no	Título da música	`Summer Dreams`
`tags`	`string`	no	Tags negativas a serem evitadas	`sad, slow`

commonParams

paramName	paramType	required	description	example
`model`	`string`	no	Modelo de IA a ser usado.	`chirp-v5-5`
`make_instrumental`	`boolean`	no	Gere música instrumental sem vocais	`false`
`gender`	`string`	no	Preferência de gênero vocal	`female`
`style_weight`	`number`	no	Força de adesão ao estilo	`0.65`
`weirdness_constraint`	`number`	no	Controla o desvio criativo	`0.65`
`audio_weight`	`number`	no	Peso de equilíbrio para recursos de áudio	`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
  }'