Udio Music Generator

Generate original music compositions using Udio AI with advanced features including flexible lyric types, negative tags for better control, and seed reproduction for consistent results.

Parameters

Parameter	Type	Required	Description
type	string	Yes	Must be "MUSIC_GENERATOR"
model	string	Yes	Must be "music-u"
conversationId	string	No	Conversation ID for context
promptObject	object	Yes	Udio-specific parameters

Prompt Object Parameters

Parameter	Type	Required	Description
lyrics_type	string	Yes	Type of lyrics: "generate", "instrumental", "user"
task_type	string	Yes	Type of task, must be "generate_music"
gpt_description_prompt	string	Yes	Describe the style and mood of music
prompt	string	No	Custom lyrics (when lyrics_type is "user")
make_instrumental	boolean	No	Whether to create instrumental version
title	string	No	Song title
tags	string	No	Genre tags, comma-separated
negative_tags	string	No	Tags to avoid, comma-separated
seed	number	No	Random seed (-1 for random)

Interactive API Testing

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

Lyrics Type *Generate - AI creates lyrics automaticallyInstrumental - No lyrics, music onlyUser - Provide custom lyrics

Music Description *upbeat electronic dance music with energetic beats

Make Instrumental No - Include vocals/lyricsYes - Instrumental only

Song Title

Genre Tags

Negative Tags

Seed

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "MUSIC_GENERATOR",
  "model": "music-u",
  "conversationId": "MUSIC_GENERATOR",
  "promptObject": {
    "lyrics_type": "generate",
    "task_type": "generate_music",
    "gpt_description_prompt": "upbeat electronic dance music with energetic beats",
    "prompt": "",
    "make_instrumental": false,
    "title": "",
    "tags": "electronic, dance, upbeat",
    "negative_tags": "slow, acoustic",
    "seed": -1
  }
}'

Response Format

Successful requests return:

{}

Example Requests

Electronic Dance Music

{
  "type": "MUSIC_GENERATOR",
  "model": "music-u",
  "promptObject": {
    "lyrics_type": "generate",
    "task_type": "generate_music",
    "gpt_description_prompt": "high-energy electronic dance music with pulsing synths and driving beats",
    "tags": "electronic, dance, EDM, synth",
    "negative_tags": "acoustic, slow",
    "make_instrumental": false
  }
}

Custom Lyrics Folk Song

{
  "type": "MUSIC_GENERATOR",
  "model": "music-u",
  "promptObject": {
    "lyrics_type": "user",
    "task_type": "generate_music",
    "gpt_description_prompt": "gentle folk song with acoustic guitar and soft vocals",
    "prompt": "Walking down the winding road\nCarrying my heavy load\nSunshine breaks through cloudy skies\nHope is dancing in my eyes",
    "tags": "folk, acoustic, gentle",
    "title": "Winding Road"
  }
}

Instrumental Jazz

{
  "type": "MUSIC_GENERATOR",
  "model": "music-u",
  "promptObject": {
    "lyrics_type": "instrumental",
    "task_type": "generate_music",
    "gpt_description_prompt": "smooth jazz with saxophone, piano, and walking bass line",
    "tags": "jazz, smooth, instrumental, saxophone",
    "negative_tags": "vocals, rock",
    "make_instrumental": true
  }
}