Text to Speech (TTS)

The Text to Speech API allows you to convert text into lifelike audio, manage voices, and process text for optimal pronunciation.

Pricing

Voice213 uses a point-based system for API usage. Points are deducted based on the operations you perform:

Operation	Cost	Notes
Text to Speech	1 point per word	Only actual words count; whitespace and punctuation are ignored
Tashkil (Diacritization)	5 points per request	Applied once per API call regardless of text length

Pricing Examples

Converting “مرحبا بك” (2 words) = 2 points
Converting “السلام عليكم ورحمة الله” (4 words) = 4 points
Example: “مرحبا بك” for tashkil = 5 points

Note: Spaces, line breaks, and punctuation marks do not count toward your point total. Only meaningful words are counted.

Generate Audio

Convert text to speech using a specific voice and settings.

POST /v1/tts

Request Body

Parameter	Type	Required	Description
`text`	string	Yes	The text to convert to speech.
`voiceId`	string	No	The ID of the voice to use. (default: nariman)
`dialect`	number	No	The ID of dialect (algerian=1 , tunisian=2 , libyan=3 ) (default: 1).
`speed`	number	No	Speech speed multiplier (default: 1.0).

Response

Returns a JSON object containing the generated audio as a Base64-encoded Data URL.


{
  "audio_data": "data:audio/wav;base64,SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjI5LjEwMAAAAAAAAAAAAAAA//NExAAAAANIAAAAAExBTUUzLjEwMKqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq//NExAAAAANIAAAAAExBTUUzLjEwMKqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq",
  "format": "audio/wav",
    "textLength": 9,
    "wordCount": 2,
    "pointsDeducted": 2
}

Voices

Get All Voices

Retrieve a list of all available voices with their IDs and attributes.

GET /api/v1/tts/voices

Response Example


{
  "success": true,
  "data": {
    "voices": [
      {
        "id": "sohila",
        "name": "سهيلة",
        "gender": "female",
        "description": "صوت امرأة لطيف"
      },
      {
        "id": "nariman",
        "name": "نريمان",
        "gender": "female",
        "description": "صوت امرأة هادئ"
      },
      {
        "id": "ryad",
        "name": "رياض",
        "gender": "male",
        "description": "صوت رجل مرح"
      },
      {
        "id": "amine",
        "name": "أمين",
        "gender": "male",
        "description": "صوت رجل عميق"
      },
      {
        "id": "ilyas",
        "name": "إلياس",
        "gender": "male",
        "description": "صوت رجل قوي"
      },
      {
        "id": "sofia",
        "name": "صوفيا",
        "gender": "female",
        "description": "صوت امرأة واضح"
      },
      {
        "id": "yanis",
        "name": "يانيس",
        "gender": "male",
        "description": "صوت رجل هادئ"
      },
      {
        "id": "ines",
        "name": "إيناس",
        "gender": "female",
        "description": "صوت امرأة شجي"
      },
      {
        "id": "chaima",
        "name": "شيماء",
        "gender": "female",
        "description": "صوت امرأة ناعم"
      },
      {
        "id": "radwan",
        "name": "رضوان",
        "gender": "male",
        "description": "صوت رجل رنان"
      },
      {
        "id": "mehdi",
        "name": "مهدي",
        "gender": "male",
        "description": "صوت رجل كلاسيكي"
      },
      {
        "id": "zouhir",
        "name": "زهير",
        "gender": "male",
        "description": "صوت رجل كلاسيكي"
      }
    ],
    "userPlan": "Pro"
  }
}

Tones

Get Voice Tones

Retrieve available tones (emotions) categorized by stages.

GET /api/v1/tts/tones

Response Example


{
  "success": true,
  "data": {
    "categories": [
      {
        "id": "first",
        "name": "المرحلة 1: جذب الانتباه وخلق الاتصال"
      },
      {
        "id": "second",
        "name": "المرحلة 2: تقديم الحل وإثارة الحماس"
      },
      {
        "id": "third",
        "name": "المرحلة 3: شرح القيمة وبناء الرغبة"
      },
      {
        "id": "fourth",
        "name": "المرحلة 4: بناء الثقة والدعوة للشراء"
      }
    ],
    "tones": {
      "first": [
        {
          "name": "مشوّق",
          "instruction": "(نبرة تساؤل وتشويق، تثير فضول المستمع)"
        },
        {
          "name": "متعب",
          "instruction": "(نبرة متعبة وبطيئة، تصف مشكلة يومية مرهقة)"
        },
        {
          "name": "منزعج",
          "instruction": "(نبرة منزعجة ومباشرة، كأنك سئمت من مشكلة متكررة)"
        },
        {
          "name": "متفهم",
          "instruction": "(نبرة هادئة ومتفهمة، تخاطب المستمع كصديق يفهمه)"
        },
        {
          "name": "حكائي",
          "instruction": "(نبرة حكائية ودافئة، تبدأ في رواية قصة قصيرة)"
        },
        {
          "name": "مرح",
          "instruction": "(نبرة مرحة وخفيفة الظل، تبدأ بلمسة من الدعابة)"
        }
      ],
      "second": [
        {
          "name": "حماسي",
          "instruction": "(تغيير مفاجئ! النبرة تصبح حماسية ومنعشة ومليئة بالطاقة)"
        },
        {
          "name": "واثق",
          "instruction": "(نبرة واثقة وهادئة، تكشف عن الحل بثقة الخبير)"
        },
        {
          "name": "مبشر",
          "instruction": "(نبرة مبشرة ومفرحة، كأنك تعلن عن خبر سار جداً)"
        },
        {
          "name": "عصري",
          "instruction": "(نبرة \"كوول\" وسلسة، تقدم شيئاً عصرياً ومتطوراً)"
        }
      ],
      "third": [
        {
          "name": "فخور",
          "instruction": "(نبرة فخورة وشغوفة، تتحدث عن جودة وأصالة المنتج)"
        },
        {
          "name": "صادق",
          "instruction": "(نبرة دافئة وصادقة، كأنك تقدم نصيحة من القلب)"
        },
        {
          "name": "عملي",
          "instruction": "(نبرة عملية وواضحة، تشرح الفوائد ببساطة ومنطق)"
        },
        {
          "name": "تعليمي",
          "instruction": "(نبرة تعليمية وموثوقة، كخبير يشرح معلومة مهمة)"
        },
        {
          "name": "فاخر",
          "instruction": "(نبرة راقية وفاخرة، تصف شيئاً ذا قيمة عالية وأناقة)"
        },
        {
          "name": "حنون",
          "instruction": "(نبرة حنونة ومتعاطفة، تظهر الاهتمام بصحة وراحة المستمع)"
        },
        {
          "name": "بسيط",
          "instruction": "(نبرة بسيطة ومريحة، تؤكد على أن المنتج سهل الاستخدام)"
        },
        {
          "name": "حصري",
          "instruction": "(نبرة خافتة ومقربة، كأنك تشارك سراً أو نصيحة حصرية)"
        }
      ],
      "fourth": [
        {
          "name": "مقنع",
          "instruction": "(نبرة مقنعة ومباشرة، تخلق شعوراً بالاستعجال الإيجابي)"
        },
        {
          "name": "عاجل",
          "instruction": "(نبرة عاجلة وحاسمة، تؤكد على أن العرض محدود ولن يدوم)"
        },
        {
          "name": "مطمئن",
          "instruction": "(نبرة مطمئنة وبسيطة، تجعل قرار الشراء يبدو سهلاً وآمناً)"
        },
        {
          "name": "حازم",
          "instruction": "(نبرة قوية وحازمة، كأنك تقدم ضماناً شخصياً لا يقبل الشك)"
        },
        {
          "name": "ودود",
          "instruction": "(نبرة ودودة ومرحبة، تدعو المستمع للانضمام لتجربة رائعة)"
        }
      ]
    }
  }
}