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.

API Endpoint

POST /api/features

Parameters

Parameter	Type	Required	Description
type	string	Yes	Must be "MUSIC_GENERATOR"
model	string	Yes	Must be "udio/music"
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"
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": "udio/music",
  "conversationId": "MUSIC_GENERATOR",
  "promptObject": {
    "lyrics_type": "generate",
    "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:

{}

Key Features

Lyric Types

• Generate: AI automatically creates lyrics based on your description
• Instrumental: Creates music without any vocals or lyrics
• User: Use your own custom lyrics

Advanced Control

• Negative Tags: Specify styles or elements to avoid in your music
• Seed Control: Use seeds for reproducible results - same seed with same parameters will generate similar music
• Genre Flexibility: Support for wide range of musical styles and genres

Best Practices

1. Descriptive Prompts: Use detailed descriptions including mood, instruments, tempo, and style
2. Tag Usage: Combine positive tags (what you want) with negative tags (what to avoid) for better results
3. Seed Experimentation: Try different seeds to find the perfect variation
4. Title Influence: Providing a title can influence the overall theme and style

Example Requests

Electronic Dance Music

{
  "type": "MUSIC_GENERATOR",
  "model": "udio/music",
  "promptObject": {
    "lyrics_type": "generate",
    "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": "udio/music",
  "promptObject": {
    "lyrics_type": "user",
    "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": "udio/music",
  "promptObject": {
    "lyrics_type": "instrumental",
    "gpt_description_prompt": "smooth jazz with saxophone, piano, and walking bass line",
    "tags": "jazz, smooth, instrumental, saxophone",
    "negative_tags": "vocals, rock",
    "make_instrumental": true
  }
}