Text-to-Speech API: Convert Text to MP3 Over REST
A text-to-speech API is a REST endpoint that turns a string into an audio file URL. On Woord that endpoint is POST https://www.getwoord.com/api/convert. Auth is Authorization: Bearer YOUR_KEY. The body is form fields, not JSON: text, gender_voice, language, optional speakingRate and effectsProfileId.
The official docs sample response is {"message":"Your audio has been created!","audio_src":"https://getwoord.s3.amazonaws.com/...mp3","error":false}. Play or download audio_src. Product docs: /pages/api_docs. Starter is $9.99/mo (billed monthly). Config caps each audio at 10,000 characters; an active trial is 8 days with 20,000 characters total and 20,000 characters max per file. The Free plan cannot call this endpoint (API returns an upgrade message).
Request: Hello World as male en_US
curl "https://www.getwoord.com/api/convert" -X POST \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
--data "text=Hello+World&gender_voice=male&language=en_US&speakingRate=1.00&effectsProfileId=telephony-class-application"
That curl is the official docs example. gender_voice is male or female. language is a locale such as en_US. speakingRate 1.00 is 1×. effectsProfileId=telephony-class-application is the telephony profile from the same example.
Response: MP3 URL
Official example from /pages/api_docs:
{
"message": "Your audio has been created!",
"audio_src": "https://getwoord.s3.amazonaws.com/4273352455515882618255eaaf3c1cbdbe0.55443890.mp3",
"error": false
}
error is false on success. audio_src is an S3 HTTPS URL to the MP3. The live converter also returns total_chars and remaining_chars; those two keys are not in the frozen docs sample above. Failure payloads set error: true and a message (quota, validation, invalid argument).
Go live with /api/convert
1. Register on a paid plan (Starter is $9.99/mo). Free cannot call the convert API.
2. Read field names on /pages/api_docs.
3. POST https://www.getwoord.com/api/convert with Bearer + form text / gender_voice / language.
4. Play audio_src. Stay under 10,000 characters per request (20,000 on trial).
FAQ: text-to-speech API
Is the body JSON?
No. The documented curl uses --data form fields. Send application/x-www-form-urlencoded.
Where is the MP3?
In audio_src, an HTTPS URL on getwoord.s3.amazonaws.com. The docs sample filename is a fixture; yours will be a new object key.
Starter vs yearly?
Starter billed monthly is $9.99. The same page’s yearly toggle shows $99.99/year for Starter. Do not mix those two numbers.
Get a key and convert Hello World →