LogoAI Music API

API 接口

生成音乐

POST/v2/generate

生成音乐API

默认音乐生成用于 AI 音乐创作的端点。支持灵感模式和自定义模式。

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

tips

默认 Music Generate endpoint：标准音乐生成请使用此路由。MiniMax 是已接入的提供商，有独立 endpoint，不是本 API 的默认模型。

两种生成模式：

  • 灵感模式：使用 gpt_description_prompt 根据文本描述生成音乐
  • 自定义模式：使用 prompt、style、title 进行精细控制

模型选择：可选 chirp-v4-0、chirp-v4-5、chirp-v4-5-plus、chirp-v5 或 chirp-v5-5，质量档位不同。可跳转查看模型介绍与积分消耗。

下一步：调用本接口提交生成任务后，请使用 音乐生成任务状态 API 轮询任务进度并获取音频链接。

requestHeaders

namerequireddescription
nameAuthorizationrequiredyesdescription用于身份验证的承载令牌
nameContent-Typerequiredyesdescriptionapplication/json

requestBody

请求体支持灵感模式或自定义模式

灵感模式

从文本描述生成音乐

paramNameparamTyperequireddescriptionexample
paramNamegpt_description_promptparamTypestringrequiredyesdescription您要生成的音乐的文字描述exampleA upbeat pop song about summer vacation with catchy melody

自定义模式

使用自定义歌词、风格和标题生成音乐

paramNameparamTyperequireddescriptionexample
paramNamepromptparamTypestringrequiredyesdescription自定义歌词或详细提示exampleVerse 1: Walking down the street, feeling so free...
paramNamestyleparamTypestringrequirednodescription音乐风格或流派examplepop, upbeat, electronic, 120 bpm
paramNametitleparamTypestringrequirednodescription歌名exampleSummer Dreams
paramNametagsparamTypestringrequirednodescription要避免的负面标签examplesad, slow

commonParams

paramNameparamTyperequireddescriptionexample
paramNamemodelparamTypestringrequirednodescription要使用的 AI 模型。examplechirp-v5-5
paramNamemake_instrumentalparamTypebooleanrequirednodescription生成没有人声的器乐examplefalse
paramNamegenderparamTypestringrequirednodescription声音性别偏好examplefemale
paramNamestyle_weightparamTypenumberrequirednodescription坚持风格的强度example0.65
paramNameweirdness_constraintparamTypenumberrequirednodescription控制创意偏差example0.65
paramNameaudio_weightparamTypenumberrequirednodescription音频功能的平衡重量example0.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);