Voice
List Tones
List the tone directions you can paste into a script, grouped by ad stage
GET
Try itcurl https://api.voice213.com/api/v1/tts/tones \
-H "Authorization: Bearer $VOICE213_API_KEY"import os
import requests
response = requests.get(
"https://api.voice213.com/api/v1/tts/tones",
headers={"Authorization": f"Bearer {os.environ['VOICE213_API_KEY']}"},
timeout=30,
)
data = response.json()["data"]
for stage in data["categories"]:
print(stage["name"], [tone["name"] for tone in data["tones"][stage["id"]]])const response = await fetch("https://api.voice213.com/api/v1/tts/tones", {
headers: { Authorization: `Bearer ${process.env.VOICE213_API_KEY}` },
});
const { data } = await response.json();
for (const stage of data.categories) {
console.log(stage.name, data.tones[stage.id].map((tone) => tone.name));
}{
"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
Your API key as a Bearer token: Bearer sk_live_.... See Authentication.
The Tone Directions page lists all 23 with English names.
Was this page helpful?