music-generation

Lyria 3 - Generate music from text

Generate original music tracks from text descriptions using Lyria 3, with optional image references to guide mood and style.

Describe the genre, mood, instruments, and tempo you want, and optionally attach reference images that inform the atmosphere of the composition. Ideal for video production, games, podcasts, and multimedia projects.

Tips for effective prompts:

  • Include genre: "cinematic", "jazz", "electronic", "ambient"
  • Describe mood: "dramatic", "playful", "tense", "peaceful"
  • Mention instruments: "grand piano", "saxophone", "synth pads", "percussion"
  • Add tempo hints: "andante", "fast-paced", "steady groove"
post/v1/ai/music-generation/lyria-3

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/music-generation/lyria-3
  • Auth: API key in header x-magnific-api-key

Request body

promptstring required

Text description of the music you want to generate with Lyria 3. Be specific about genre, mood, instruments, and tempo for best results.

Tips for effective prompts:

  • Include genre: "cinematic", "jazz", "electronic", "ambient"
  • Describe mood: "dramatic", "playful", "tense", "peaceful"
  • Mention instruments: "grand piano", "saxophone", "synth pads", "percussion"
  • Add tempo hints: "andante", "fast-paced", "steady groove"
model'clip' | 'pro'

Lyria 3 generation model variant.

Available models:

  • clip: Faster generation optimized for short clips (default)
  • pro: Higher-fidelity generation for professional-quality tracks
webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example request

{
  "prompt": "Cinematic ambient track with warm synth pads, soft piano, and a gentle build",
  "model": "clip",
  "reference_images": [
    {
      "image": "https://example.com/mood-reference.jpg",
      "mime_type": "image/jpeg"
    }
  ],
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.