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 10,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 - 10000
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 voice consistency and expressiveness. Lower values produce more expressive, varied delivery; higher values produce more consistent, stable output.

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: