LogoAI Music API

API 엔드포인트

음악 생성

POST/v2/generate

음악 API 생성

AI 음악 생성을 위한 기본 음악 생성 엔드포인트입니다. 인스퍼레이션 모드와 커스텀 모드를 모두 지원합니다.

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

tips

기본 엔드포인트: 표준 생성을 위해 /v2/generate를 사용합니다.

모드: Inspiration 모드는 gpt_description_prompt를 사용합니다. 사용자 정의 모드는 프롬프트, 스타일, 제목을 사용합니다.

모델 선택: chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5, chirp-v5-5 중 선택할 수 있습니다. 모델 소개 및 크레딧 소모량을 확인하세요.

다음 단계: 이 엔드포인트를 호출한 후 음악 생성 작업 상태 API를 사용하여 작업 진행 상황을 폴링하고 오디오 URL을 가져오세요.

requestHeaders

namerequireddescription
Authorizationyes인증을 위한 Bearer 토큰
Content-Typeyesapplication/json

requestBody

요청 본문은 영감 모드 또는 사용자 정의 모드를 지원합니다.

영감 모드

텍스트 설명에서 음악 생성

paramNameparamTyperequireddescriptionexample
gpt_description_promptstringyes생성하려는 음악에 대한 텍스트 설명A upbeat pop song about summer vacation with catchy melody

사용자 정의 모드

맞춤 가사, 스타일, 제목으로 음악 생성

paramNameparamTyperequireddescriptionexample
promptstringyes맞춤 가사 또는 자세한 프롬프트Verse 1: Walking down the street, feeling so free...
stylestringno음악 스타일이나 장르pop, upbeat, electronic, 120 bpm
titlestringno노래 제목Summer Dreams
tagsstringno피해야 할 부정적인 태그sad, slow

commonParams

paramNameparamTyperequireddescriptionexample
modelstringno사용할 AI 모델.chirp-v5-5
make_instrumentalbooleanno보컬 없이 악기 음악 생성false
genderstringno보컬 성별 선호도female
style_weightnumberno스타일 고수의 강점0.65
weirdness_constraintnumberno창의적인 편차를 제어합니다.0.65
audio_weightnumberno오디오 기능을 위한 균형추0.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);