πŸš€ Introduction

The Text to Speech API turns written scripts into studio-quality voiceovers using Creatify’s AI voices. Perfect for narration, educational content, promotional videos, and more β€” with support for natural-sounding accents and expressive delivery.


βš™οΈ Quickstart Guide

βœ… Prerequisites

Before you begin, ensure you have:


🧠 Step 1: Choose a Voice Accent

Call the Get Voices API to retrieve a list of available voices and their accents.

Each voice includes an accents list β€” select one of the id values from that list and use it as the accent in your TTS request.

🎧 Example Response from GET /api/voices/

[
  {
    "name": "Fatima",
    "gender": "female",
    "accents": [
      {
        "id": "7a258b67-e1d3-4025-8904-8429daa3a34d",
        "accent_name": "American English accent",
        "preview_url": "https://d35ghwdno3nak3.cloudfront.net/accent_preview_new_/el-689d6bc2-c93e-4a50-a36b-3b171c729843_s.mp3"
      }
    ]
  }
]

πŸ“ Step 2: Submit a TTS Generation Request

Use this endpoint to generate voiceover audio from a script.

curl --request POST \
  --url https://api.creatify.ai/api/text_to_speech/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "script": "Welcome to Creatify dot AI!",
    "accent": "7a258b67-e1d3-4025-8904-8429daa3a34d"
  }'

⚠️ Save the id β€” you’ll need it to check the generation status.


⏳ Step 3: Check Audio Generation Status

Use the ID returned from your generation request to retrieve the final voiceover file.

curl --request GET \
  --url https://api.creatify.ai/api/text_to_speech/819916b3-ec00-4baa-a6be-18635ad97d53/ \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key'

⏳ Once status is done, download the voiceover from the output field.


🎯 Summary

StepEndpoint
Get VoicesGET /api/voices/
Create AudioPOST /api/text_to_speech/
Check StatusGET /api/text_to_speech/{id}/
API ReferenceText to Speech Reference

🀝 Need Help?

If you run into any issues, check out our API Reference or contact api@creatify.ai.