LogoAI Music API

Endpoints da API

Gerar música

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

namerequireddescription
nameAuthorizationrequiredyesdescriptionToken de portador para autenticação
nameContent-Typerequiredyesdescriptionapplication/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

paramNameparamTyperequireddescriptionexample
paramNamegpt_description_promptparamTypestringrequiredyesdescriptionDescrição de texto da música que você deseja gerarexampleA upbeat pop song about summer vacation with catchy melody

Modo personalizado

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

paramNameparamTyperequireddescriptionexample
paramNamepromptparamTypestringrequiredyesdescriptionLetras personalizadas ou prompt detalhadoexampleVerse 1: Walking down the street, feeling so free...
paramNamestyleparamTypestringrequirednodescriptionEstilo ou gênero musicalexamplepop, upbeat, electronic, 120 bpm
paramNametitleparamTypestringrequirednodescriptionTítulo da músicaexampleSummer Dreams
paramNametagsparamTypestringrequirednodescriptionTags negativas a serem evitadasexamplesad, slow

commonParams

paramNameparamTyperequireddescriptionexample
paramNamemodelparamTypestringrequirednodescriptionModelo de IA a ser usado.examplechirp-v5-5
paramNamemake_instrumentalparamTypebooleanrequirednodescriptionGere música instrumental sem vocaisexamplefalse
paramNamegenderparamTypestringrequirednodescriptionPreferência de gênero vocalexamplefemale
paramNamestyle_weightparamTypenumberrequirednodescriptionForça de adesão ao estiloexample0.65
paramNameweirdness_constraintparamTypenumberrequirednodescriptionControla o desvio criativoexample0.65
paramNameaudio_weightparamTypenumberrequirednodescriptionPeso de equilíbrio para recursos de áudioexample0.65

responses

json
{
  "code": 200,
  "message": "success",
  "workId": "gen2abc123def456bksv",
  "data": {
    "task_id": "gen2abc123def456bksv"
  }
}
json
{
  "code": 400,
  "message": "No body provided"
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header"
}
json
{
  "code": 500,
  "message": "Internal Server Error",
  "data": {
    "task_id": "gen2abc123def456bksv"
  },
  "workId": "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
  }'
javascript
const response = await fetch('https://udioapi.pro/api/v2/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'chirp-v4-5',
    gpt_description_prompt: 'A upbeat pop song about summer vacation with catchy melody',
    make_instrumental: false,
    gender: 'female',
    style_weight: 0.65,
    weirdness_constraint: 0.65,
    audio_weight: 0.65
  })
});

const data = await response.json();
console.log(data);
javascript
const response = await fetch('https://udioapi.pro/api/v2/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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
  })
});

const data = await response.json();
console.log(data);