Music Generation

Generate high-quality music using AI with customizable prompts and duration settings.

Basic Music Generation

curl -X POST https://api.mondialspeech.com/api/v1/media/music \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Upbeat electronic music","durationSeconds":30}'

Request Parameters

Prompt Examples

Genre-based

• "Jazz piano with smooth saxophone"
• "Electronic dance music with heavy bass"
• "Classical orchestral piece"
• "Rock guitar solo with drums"

Mood-based

• "Calm and peaceful ambient music"
• "Energetic and uplifting soundtrack"
• "Melancholic piano melody"
• "Epic cinematic orchestral"

Style-based

• "80s synthwave with retro vibes"
• "Modern trap beat with 808s"
• "Acoustic folk guitar"
• "Futuristic sci-fi soundscape"

Duration Limits

• Minimum: 5 seconds
• Maximum: 120 seconds
• Default: 30 seconds

Cost Estimation

curl -X GET "https://api.mondialspeech.com/api/v1/media/estimate/music?durationSeconds=30" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Response

The API returns the generated music file as MP3 format.

Error Handling

402 Payment Required (Insufficient Tokens)

{ "error": "Insufficient tokens", "tokens_needed": 2000 }

400 Bad Request (Invalid Duration)

{ "error": "Duration must be between 5 and 120 seconds" }

400 Bad Request (Invalid Prompt)

{ "error": "Prompt cannot be empty" }

Best Practices

1. Be specific in your prompts for better results
2. Use descriptive language for mood and style
3. Consider duration for cost optimization
4. Experiment with different prompts to find your style

Advanced Tips

Prompt Engineering

• Combine genre + mood + instruments
• Use specific musical terms
• Mention tempo preferences
• Include emotional descriptors

Examples

# Specific genre and mood
{"prompt": "Dark ambient music with haunting synthesizers", "durationSeconds": 45}

# Instrument-focused
{"prompt": "Acoustic guitar fingerpicking with soft vocals", "durationSeconds": 60}

# Cinematic style
{"prompt": "Epic orchestral soundtrack for action scene", "durationSeconds": 90}

Related