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
​
text
string
required

The text to convert to speech, up to 5,000 characters. Supports UTF-8 characters including accented letters and non-Latin scripts.

Inline audio tags in square brackets direct the performance instead of being read aloud, e.g. [excited], [whispers], [laughs] or [pause 1s].

Required string length: 1 - 5000
Example:

"[excited] Welcome to Magnific! [pause 0.5s] Let's create something amazing."

​
voice_id
string
required

The unique identifier of the ElevenLabs voice to use for synthesis. You can find voice IDs in the ElevenLabs voice library.

Required string length: 1 - 255
Pattern: ^[a-zA-Z0-9_-]+$
Example:

"21m00Tcm4TlvDq8ikWAM"

​
stability
number
default:0.5

Controls how closely the delivery sticks to the voice versus how freely it performs the text: 0.0 (Creative) is the most expressive and follows audio tags most strongly, 0.5 (Natural) is balanced, 1.0 (Robust) is the most consistent.

Required range: 0 <= x <= 1
Example:

0.5

​
similarity_boost
number
default:0.75

Controls how closely the generated voice matches the original voice. Higher values produce closer matching.

Required range: 0 <= x <= 1
Example:

0.75

​
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 - Task created successfully

​
data
object
required
Example: