Skip to content
GET
https://api.voice213.com/api/v1/tts/tones
Try it
curl https://api.voice213.com/api/v1/tts/tones \
  -H "Authorization: Bearer $VOICE213_API_KEY"
{
  "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": "(نبرة ودودة ومرحبة، تدعو المستمع للانضمام لتجربة رائعة)" }
      ]
    }
  }
}

Returns the 23 tone directions you can paste into a script, grouped by the four stages of an ad. It's free, and it doesn't count toward your rate limits.

A tone direction is an instruction in parentheses, placed before the words it applies to. The voice performs it instead of reading it, and it isn't billed as long as it's at most 100 characters long, parentheses included: all 23 are well under that. See Tone Directions for how to use them.

Authorizations

Authorizationstringrequired

Your API key as a Bearer token: Bearer sk_live_.... See Authentication.

Response

application/json
successbooleanrequired

true.

dataobjectrequired

The stages and their tones.

Show properties
categoriesobject[]required

The four stages of an ad, in order.

Show properties
idenum<string>required

first, second, third or fourth: the key of the stage's tones in tones.

namestringrequired

The stage's name in Arabic, such as «المرحلة 1: جذب الانتباه وخلق الاتصال» ("Stage 1: grab attention and connect").

tonesobjectrequired

The tones of each stage, keyed by the stage's id: a list of tones for each.

Show properties
namestringrequired

The tone's name in Arabic, such as «واثق» ("confident").

instructionstringrequired

The tone direction to paste into your script, parentheses included, such as «(نبرة واثقة وهادئة، تكشف عن الحل بثقة الخبير)».

The Tone Directions page lists all 23 with English names.

Was this page helpful?