Skip to main content
POST

Authorizations

​
x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
prompt
string
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"
Required string length: 10 - 2000
Example:

"Cinematic ambient track with warm synth pads, soft piano, and a gentle build"

​
model
enum<string>
default:clip

Lyria 3 generation model variant.

Available models:

  • clip: Faster generation optimized for short clips (default)
  • pro: Higher-fidelity generation for professional-quality tracks
Available options:
clip,
pro
Example:

"clip"

​
reference_images
object[]

Optional reference images to guide the mood and style of the generated music. Each entry must include the image URL and its MIME type.

Image requirements:

  • Publicly accessible URLs or GCS format
  • Supported formats: PNG, JPEG, WebP
Example:
​
webhook_url
string<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:

"https://www.example.com/webhook"

Response

OK - The task exists and the status is returned

​
data
object
required
Example: