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 Google Lyria. Be specific about genre, mood, instruments, and tempo for best results.

Tips for effective prompts:

  • Include genre: "lo-fi hip hop", "orchestral", "synthwave", "acoustic folk"
  • Describe mood: "uplifting", "melancholic", "energetic", "relaxed"
  • Mention instruments: "piano", "strings", "electric guitar", "808 drums"
  • Add tempo hints: "slow tempo", "upbeat", "driving rhythm"
Required string length: 1 - 2500
Example:

"Uplifting orchestral score with soaring strings and triumphant brass"

​
negative_prompt
string

Text describing elements to avoid in the generated track, such as unwanted instruments, styles, or moods.

Example:

"vocals, distortion, dissonance"

​
seed
integer

Seed for reproducible generation. Using the same prompt and seed returns a consistent result across requests. Omit to get a random seed on each request.

Example:

12345

​
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: