LogoAI Music API
Se connecter

Points d'accès API

Point de rappel

POST/generate

POST /generate

Generate music using AI with callback support. Supports both inspiration mode (text description) and custom mode (lyrics, style, title).

POSThttps://udioapi.pro/api/generate

tips

This endpoint generates music and sends results to your callback URL when completed.

Callback URL Requirements:

  • Must be publicly accessible (no localhost, internal IPs, or private networks)
  • Must accept POST requests
  • Will receive an array of generation results in the request body

Two Generation Modes:

  • Inspiration Mode: Use gpt_description_prompt to generate music from a text description
  • Custom Mode: Use prompt, style, and title for detailed control

Callbacks are sent at each stage: text generation, first audio, and completion.

requestHeaders

namerequireddescription
nameAuthorizationrequiredyesdescriptionBearer token for authentication
nameContent-Typerequiredyesdescriptionapplication/json

requestBody

Request body supports two modes: Inspiration Mode or Custom Mode, plus callback URL

Inspiration Mode

Generate music from a text description

paramNameparamTyperequireddescriptionexample
paramNamegpt_description_promptparamTypestringrequiredyesdescriptionText description of the music you want to generate. Max length: 3000 characters (longer input is truncated). Optional when image_urls is provided.exampleA upbeat pop song about summer vacation with catchy melody

Custom Mode

Generate music with custom lyrics, style, and title

paramNameparamTyperequireddescriptionexample
paramNamepromptparamTypestringrequiredyesdescriptionCustom lyrics or detailed prompt. Max length: 5000 characters for every model (longer input is truncated).exampleVerse 1: Walking down the street, feeling so free...
paramNamestyleparamTypestringrequirednodescriptionMusical style/genre. Max length: 1000 characters for every model (longer input is truncated).examplepop, upbeat, electronic, 120 bpm
paramNametitleparamTypestringrequirednodescriptionSong title. Max length: 80 characters (longer input is truncated).exampleSummer Dreams
paramNametagsparamTypestringrequirednodescriptionNegative tags to avoid in generationexamplesad, slow

commonParams

paramNameparamTyperequireddescriptionexample
paramNamecallback_urlparamTypestringrequiredyesdescriptionURL to receive generation results callbacks. Must be publicly accessible.examplehttps://your-domain.com/api/callback
paramNamemodelparamTypestringrequirednodescriptionModel to use. Current options: 'chirp-v6' (12 credits), 'chirp-v6-mini' (10 credits), 'chirp-v6-wild' (12 credits). Legacy identifiers 'chirp-v3-5' (5), 'chirp-v4-0' (8), 'chirp-v4-5' (10), 'chirp-v4-5-plus' (10), 'chirp-v5' (12) and 'chirp-v5-5' (12) keep their historical price and are served by chirp-v6 (chirp-v5 / chirp-v5-5) or chirp-v6-mini (all others). When omitted the request is billed at the 5-credit base tier and served by chirp-v6-mini.examplechirp-v6
paramNameimage_urlsparamTypestring[]requirednodescriptionImage to Music. Up to 5 publicly accessible image URLs (JPEG, JPG, PNG or WEBP, max 10MB each). Adds 1 credit per request. Inspiration Mode only; silently ignored in Custom Mode.example["https://cdn.example.com/sunset-beach.jpg"]
paramNamemake_instrumentalparamTypebooleanrequirednodescriptionGenerate instrumental music without vocalsexamplefalse
paramNamegenderparamTypestringrequirednodescriptionVocal gender preference. Use 'male' or 'female'examplefemale
paramNamestyle_weightparamTypenumberrequirednodescriptionStrength of adherence to style. Range 0–1, up to 2 decimalsexample0.65
paramNameweirdness_constraintparamTypenumberrequirednodescriptionControls creative deviation. Range 0–1, up to 2 decimalsexample0.65
paramNameaudio_weightparamTypenumberrequirednodescriptionBalance weight for audio features. Range 0–1, up to 2 decimalsexample0.65

responses

json
{
  "code": 200,
  "message": "success",
  "workId": "gen2abc123def456bksv",
  "data": {
    "task_id": "gen2abc123def456bksv"
  }
}
json
{
  "code": 400,
  "message": "callback_url is required"
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header"
}
json
{
  "code": 500,
  "message": "Internal Server Error",
  "data": {
    "task_id": "gen2abc123def456bksv"
  },
  "workId": "gen2abc123def456bksv"
}
json
[
  {
    "id": "081a452c-45e2-44d2-88cc-15e06fb2544d",
    "audio_url": "",
    "image_url": "https://image_.jpeg",
    "image_large_url": "https://image_0.jpeg",
    "created_at": "2025-08-19T23:07:28.936Z",
    "createTime": "2025-08-19T23:07:28.936Z",
    "timestamp": 1755616048327,
    "status": "text",
    "title": "xxxx",
    "prompt": "xxxxxxxxx",
    "tags": "xxx",
    "duration": "",
    "model_name": "chirp-v6",
    "extra_message": "Text generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "2a20be9d-c876-45e3-a3ed-867b5bf3c4e6",
    "audio_url": "",
    "image_url": "https://image_.jpeg",
    "image_large_url": "https://image_.jpeg",
    "created_at": "2025-08-19T23:07:28.936Z",
    "createTime": "2025-08-19T23:07:28.936Z",
    "timestamp": 1755616048327,
    "status": "text",
    "title": "xxxx",
    "prompt": "xxxxxxxx",
    "tags": "xxxxx",
    "duration": "",
    "model_name": "chirp-v6",
    "extra_message": "Text generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]
json
[
  {
    "id": "081a452c-45e2-44d2-88cc-15e06fb2544d",
    "audio_url": "https://xxxx.mp3",
    "image_url": "https://xxxx.jpeg",
    "image_large_url": "https://xxxx.jpeg",
    "created_at": "2025-08-19T23:09:09.050Z",
    "createTime": "2025-08-19T23:09:09.050Z",
    "timestamp": 1755616048327,
    "status": "first",
    "title": "xxxx",
    "prompt": "xxxxx",
    "tags": "xxx",
    "duration": 156.36,
    "model_name": "chirp-v6",
    "extra_message": "First audio generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "2a20be9d-c876-45e3-a3ed-867b5bf3c4e6",
    "audio_url": "",
    "image_url": "https://xxxx.jpeg",
    "image_large_url": "https://xxxxx.jpeg",
    "created_at": "2025-08-19T23:09:09.050Z",
    "createTime": "2025-08-19T23:09:09.050Z",
    "timestamp": 1755616048327,
    "status": "first",
    "title": "xxxx",
    "prompt": "xxxxxxx",
    "tags": "xxxxx",
    "duration": "",
    "model_name": "chirp-v6",
    "extra_message": "First audio generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]
json
[
  {
    "id": "94316433-5bf5-4fb2-9285-83e60aaca920",
    "audio_url": "https://xxxx.mp3",
    "image_url": "https://xxx.jpeg",
    "image_large_url": "https://xxx.jpeg",
    "created_at": "2025-08-19T23:20:53.879Z",
    "createTime": "2025-08-19T23:20:53.879Z",
    "timestamp": 1755616853152,
    "status": "complete",
    "title": "xxxx",
    "prompt": "xxxxx",
    "tags": "xxxx",
    "duration": 122,
    "model_name": "chirp-v6",
    "extra_message": "All generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "8206443a-1bd8-4cfd-8ef2-29c16b25c8b7",
    "audio_url": "https://xxxxx.mp3",
    "image_url": "https://xxxxxx.jpeg",
    "image_large_url": "https://xxxxx.jpeg",
    "created_at": "2025-08-19T23:20:53.879Z",
    "createTime": "2025-08-19T23:20:53.879Z",
    "timestamp": 1755616853152,
    "status": "complete",
    "title": "xxxx",
    "prompt": "xxx",
    "tags": "xxxx",
    "duration": 178.64,
    "model_name": "chirp-v6",
    "extra_message": "All generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]

codeExamples

curl
curl -X POST "https://udioapi.pro/api/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-domain.com/api/callback",
    "model": "chirp-v6-mini",
    "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
  }'
curl
curl -X POST "https://udioapi.pro/api/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-domain.com/api/callback",
    "model": "chirp-v6-mini",
    "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/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    callback_url: 'https://your-domain.com/api/callback',
    model: 'chirp-v6-mini',
    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/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    callback_url: 'https://your-domain.com/api/callback',
    model: 'chirp-v6-mini',
    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);
python
import requests

url = "https://udioapi.pro/api/generate"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "callback_url": "https://your-domain.com/api/callback",
    "model": "chirp-v6-mini",
    "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
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
python
import requests

url = "https://udioapi.pro/api/generate"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "callback_url": "https://your-domain.com/api/callback",
    "model": "chirp-v6-mini",
    "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
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
javascript
// Example callback endpoint to receive generation results
app.post('/api/callback', express.json(), (req, res) => {
  const results = req.body; // Array of generation results
  
  console.log('Received callback:', results);
  
  // Process each result
  results.forEach(result => {
    console.log(`Task ${result.id} status: ${result.status}`);
    
    switch(result.status) {
      case 'text':
        console.log('Lyrics generated:', result.title);
        break;
      case 'first':
        console.log('First audio ready:', result.audio_url);
        break;
      case 'complete':
        console.log('All audio complete:', result.audio_url);
        // Save to database, notify user, etc.
        break;
    }
  });
  
  // Always respond with 200 OK
  res.status(200).json({ received: true });
});