دليل المطورين لواجهة تحويل النص إلى صوت API

بواسطة فريق تحرير Natiq · تم التحديث 2026-11-18

تقدم هذه الصفحة دليلًا تقنيًا شاملاً لمطوري البرمجيات المستقلين الذين يعملون على أنظمة IVR والمكالمات الخارجية. نوضح لك خطوة بخطوة كيفية دمج واجهة برمجة التطبيقات (API) لتحويل النص إلى صوت في نظامك، بدءًا من إنشاء المفتاح وإعداد الاتصال، وصولاً إلى معالجة الأخطاء والحدود التقنية.

ستجد هنا أمثلة عملية لطلبات cURL، وتكوين مكتبة OpenAI SDK، وتفاصيل دقيقة حول الأصوات الثمانية المدعومة، اللغات الـ23، وسرعة الكلام. هذا الدليل مصمم خصيصًا لتسهيل عملية البناء والاختبار، مع التركيز على الدقة والسيطرة الكاملة على مخرجات الصوت عبر واجهة برمجية بسيطة وموثوقة.

دليل المطورين لواجهة تحويل النص إلى صوت API

الأسئلة الشائعة

كيف أحصل على مفتاح API؟

سجّل حسابك في صفحة /get-api-key/ باستخدام حساب Google أو البريد الإلكتروني وكلمة المرور. بعد التسجيل، ستظهر لك الصفحة المفتاح الخاص بك، الرصيد المتاح، وعدد الأحرف المتبقية. يمكنك استخدام هذا المفتاح مباشرة في طلباتك عبر إضافة رأس المصادقة Authorization: Bearer tts-...

ما هي صيغة الطلب المطلوبة؟

أرسل طلب POST إلى https://api.playcv6.com/v1/audio/speech. يجب أن يكون جسم الطلب بصيغة JSON يحتوي على الحقول: model، input، voice، response_format، وspeed. يمكنك تحديد language اختياريًا. تأكد من تضمين رأس Authorization: Bearer مع مفتاح API الخاص بك في كل طلب.

هل يمكنني استخدام مكتبة OpenAI؟

نعم، يمكنك استخدام مكتبات OpenAI الرسمية. قم بتغيير base_url إلى https://api.playcv6.com/v1 واستخدم مفتاح API الخاص بنا. هذا يعمل لأن شكل الطلب مطابق لنموذج OpenAI. لا نوفر SDK خاص بنا، لذا اعتمد على HTTP المباشر أو مكتبات الطرف الثالث.

ما هي القيم المسموحة للنموذج؟

القيم المسموحة للنموذج هي 'tts-1' و 'tts-1-hd'. كلاهما يستخدمان نفس محرك التوليد ونفس التسعيرة. يمكنك اختيار أي منهما بناءً على تفضيلك دون تأثير على التكلفة أو جودة الصوت الأساسية، حيث أن الفرق يكمن في إعدادات المعالجة الداخلية.

ما هي القيم المسموحة للصوت؟

يمكنك اختيار أحد الأصوات الثمانية التالية: aria، nova، luna، sage (إناث)، وfelix، milo، atlas، orion (ذكور). كل صوت له نبرة مميزة تناسب سياقات مختلفة مثل السرديات أو الأخبار أو الإعلانات. يمكنك تغيير الصوت في كل طلب على حدة.

ما هي الصيغ الصوتية المدعومة؟

الصيغ المدعومة هي: mp3، wav، opus، flac، وpcm. يمكنك تحديد الصيغة المطلوبة عبر حقل response_format في طلبك. اختر mp3 أو opus للملفات المضغوطة، أو wav/flac للجودة العالية غير المضغوطة، حسب احتياجات نظام الـ IVR أو المكالمات الخارجية لديك.

كيف أحدد لغة النص؟

حدد لغة النص عبر الحقل language باستخدام رمز ISO المختار. إذا لم تحدده، سيتم تخمين اللغة بناءً على النص (اللاتيني يُفترض أنه إنجليزي افتراضيًا). يُنصح بتعيين اللغة صراحةً للنصوص اللاتينية غير الإنجليزية لضمان دقة النطق الصحيح في نظام المكالمات.

ما هو نطاق سرعة الكلام؟

نطاق سرعة الكلام يتراوح بين 0.25 و 4.0. القيمة الافتراضية هي 1.0. يمكنك تسريع أو إبطاء الكلام لتحسين وضوح الرسالة في أنظمة الـ IVR. السرعة الأعلى قد تجعل الصوت يبدو آليًا قليلاً، لذا اختبر القيم المناسبة لجمهورك المستهدف.

ماذا يحدث عند تجاوز حد الطلبات؟

حد الطلبات هو 60 طلبًا في الدقيقة لكل مفتاح (10 قبل أول إيداع). عند تجاوز الحد، قد تواجه تأخيرًا في المعالجة أو رفض الطلبات مؤقتًا. المعالجة تتم بالتسلسل، لذا قد ينتظر الطلب في الطابور تحت الضغط. راقب استجابة الخادم لتجنب التكرار المتكرر.

هل يتم تخزين النصوص المدخلة؟

لا، النصوص المدخلة تُستخدم فقط لإنتاج ملف الصوت ولا تُستخدم للتدريب. ملف الصوت يتم إرجاعه في الاستجابة ولا يتم تخزينه. نحتفظ فقط ببيانات الطلب (الوقت، الأحرف، الحالة) لأغراض الفوترة. خصوصية بياناتك مضمنة ضمن حدود الاستخدام الفوري.

كيف أتعامل مع الأخطاء في الطلب؟

إذا فشل التوليد، يتم إرجاع المبلغ بالكامل. تحقق من أكواد الحالة في الاستجابة. الأخطاء الشائعة تشمل النصوص الطويلة جدًا أو المفاتيح غير الصحيحة. لا يوجد ضمان توفر (SLA)، لذا قم بتنفيذ منطق إعادة المحاولة في كودك مع مراعاة حدود معدل الطلبات.

ما هو الحد الأقصى لطول النص؟

الحد الأقصى هو 4096 حرفًا لكل طلب. إذا كان النص أطول، قم بتقسيمه إلى أجزاء لا تتجاوز هذا الحد. ثم اجمع ملفات الصوت الناتجة في ملف واحد. احسب الأحرف بما في ذلك المسافات وعلامات الترقيم لضمان عدم تجاوز الحد المسموح.

هل يمكنني تغيير مفتاح API؟

نعم، يمكنك إصدار مفتاح جديد في أي وقت من لوحة التحكم. عند إصدار مفتاح جديد، يتوقف المفتاح القديم فورًا. هذا مفيد لإعادة التدوير الأمني أو عند مشاركة المفتاح مع فرق متعددة. تأكد من تحديث مفتاحك في تطبيقاتك بعد التغيير.

كيف أتحقق من الرصيد عبر API؟

يمكنك التحقق من الرصيد والحجم المستخدم عبر واجهة المستخدم في صفحة الحساب. لا توجد نقطة نهاية محددة للتحقق من الرصيد عبر API مباشرة. استخدم الصفحة المخصصة لرؤية الرصيد، رصيد التجربة، والأحرف المتبقية بدقة.

الطلب الأول

curl

curl https://api.playcv6.com/v1/audio/speech \
  -H "Authorization: Bearer $TTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
  --output hello.mp3

Python (openai)

from openai import OpenAI

client = OpenAI(base_url="https://api.playcv6.com/v1", api_key="tts-...")

with client.audio.speech.with_streaming_response.create(
    model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
    response.stream_to_file("hello.mp3")

Node.js (openai)

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({ baseURL: "https://api.playcv6.com/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));
voice
ariaأنثى
novaأنثى
lunaأنثى
sageأنثى
felixذكر
miloذكر
atlasذكر
orionذكر
language
arالعربية
zh中文
daDansk
nlNederlands
enEnglish
fiSuomi
frFrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
itItaliano
ja日本語
ko한국어
msBahasa Melayu
noNorsk
plPolski
ptPortuguês
ruРусский
esEspañol
swKiswahili
svSvenska
trTürkçe

الحصول على مفتاح API

رسم توضيحي لموجة الصوت لـ: الحصول على مفتاح API

لبدء الاستخدام، قم بإنشاء حساب على playcv6.com عبر تسجيل الدخول بحساب Google أو البريد الإلكتروني. سيظهر لك في لوحة التحكم مفتاح API النشط، والرصيد الحالي، وعدد الأحرف المتبقية، مع مثال curl جاهز للاستخدام.

يتم إصدار مفتاح واحد نشط لكل حساب. يمكنك إصدار مفتاح جديد في أي وقت، حيث يتوقف المفتاح القديم فورًا. هذا يضمن أمانًا بسيطًا وسهولة في إدارة الوصول للأنظمة الخاصة بك.

إنشاء حساب جديد

إنشاء حساب جديد

سجل حسابك عبر صفحة /get-api-key/ باستخدام Google أو البريد الإلكتروني وكلمة المرور. إذا استخدمت Google، ستحصل على رصيد تجريبي بقيمة 0.50 دولار (حوالي 50,000 حرف) صالح لمدة 7 أيام. حسابات البريد الإلكتروني تبدأ بدون رصيد تجريبي.

تفعيل مفتاح API

بعد التسجيل، يظهر لك مفتاح يبدأ بـ tts-.... استخدمه في رأس الطلب Authorization: Bearer لإرسال النصوص. لا توجد خطة شهرية أو حد أدنى للإنفاق، والدفع يتم حسب الاستخدام الفعلي.

  • المفتاح يبدأ بـ tts-.
  • يتم تفعيله فور ظهوره في لوحة التحكم.

إدارة المفاتيح والأمان

يمكنك إصدار مفتاح جديد في أي وقت من لوحة التحكم. عند الإصدار، يصبح المفتاح القديم غير صالح فورًا. هذا مفيد لاستبدال المفاتيح إذا تم مشاركتها أو خسارتها دون الحاجة إلى إعادة التسجيل.

طلب CURL الأول

رسم توضيحي لموجة الصوت لـ: طلب CURL الأول

ابدأ بتجربة الـ API مباشرة عبر سطر الأوامر. تحتاج فقط إلى إرسال نص بسيط باستخدام نموذج tts-1 أو tts-1-hd. تأكد من استبدال YOUR_API_KEY بمفتاحك الفعلي، وتحديد الصوت واللغة المطلوبة في الجسم JSON.

يُرجى ملاحظة أن الطلب يتوقع استجابة صوتية مباشرة. ستحتاج إلى ضبط معرّف المحتوى (Content-Type) وتهيئة رأس المصادقة (Authorization) بشكل صحيح لضمان نجاح التوليد واستلام الملف الصوتي.

هيكل الطلب JSON

يتطلب الطلب إرسال بيانات بصيغة JSON تحدد النموذج (model)، النص المدخل (input)، الصوت (voice)، والصيغة المطلوبة (response_format). يمكنك ضبط السرعة (speed) بين 0.25 و4.0 لتناسب سناريوهات IVR المختلفة.

  • Endpoint: POST https://api.playcv6.com/v1/audio/speech
  • Headers: Content-Type: application/json, Authorization: Bearer YOUR_API_KEY
  • Body fields: model, input, voice, response_format, speed

إرسال النص واستقبال الصوت

عند إرسال الطلب بنجاح، ستستلم استجابة تحتوي على ملف الصوت مباشرة (MP3، WAV، OPUS، FLAC، أو PCM) حسب اختيارك. هذا يسمح بدمج الاستجابة مباشرة في خطوط المكالمات دون الحاجة لعمليات معالجة وسيطة معقدة.

استخدام OpenAI SDK

رسم توضيحي لموجة الصوت لـ: استخدام OpenAI SDK

تتوافق واجهة Natiq تمامًا مع بروتوكول OpenAI، مما يسمح للمطورين باستخدام مكتبات OpenAI SDK المعروفة دون الحاجة لكتابة كود HTTP مخصص من الصفر. هذا التوافق يسهل دمج خدمة تحويل النص إلى صوت في أنظمة IVR والمكالمات الخارجية بسرعة ودقة.

للاستخدام، تحتاج فقط إلى تعديل نقطة النهاية (base_url) في إعدادات العميل للإشارة إلى خوادمنا الخاصة. بعد هذا التغيير البسيط، يمكنك استخدام نفس كائنات الطلب والاستجابة المعتادة، مع ضمان عمل المفاتيح (API Keys) بنفس آلية المصادقة القياسية.

تغيير base_url

لتوجيه الطلبات إلى Natiq، قم بتعيين متغير base_url في كودك إلى https://api.playcv6.com/v1. هذا هو المسار الأساسي لجميع نقاط النهاية، بما في ذلك توليد الصوت (/audio/speech) وقائمة الأصوات (/voices).

عند استخدام هذا العنوان، ستعمل المكتبات بتحديد الطلبات بشكل صحيح نحو خوادمنا. تأكد من أن مفتاح API الخاص بك يبدأ بـ tts- ويتم إرساله في رأس الطلب (Authorization: Bearer <key>).

  • القاعدة الأساسية: https://api.playcv6.com/v1
  • نقطة نهاية الصوت: /audio/speech
  • نقطة نهاية الأصوات: /voices

تكوين العميل (Client Setup)

في Python، قم باستيراد مكتبة OpenAI وقم بإنشاء كائن العميل مع تمرير مفتاح API ونقطة النهاية المخصصة. تأكد من أن المكتبة تدعم إصدارًا حديثًا يتعامل مع التعديلات الديناميكية للـ URL.

مثال بسيط: client = OpenAI(base_url="https://api.playcv6.com/v1", api_key="tts-..."). بعد هذا الإعداد، يمكنك استدعاء client.audio.speech.create() بنفس الطريقة المعتادة، مع تمرير النص والصوت والسرعة كمعاملات قياسية.

  • استخدم OpenAI من المكتبة القياسية
  • حدد base_url بدقة
  • أدخل مفتاح tts-... في api_key
  • استدعاء audio.speech.create() للتوليد

المعاملات المتاحة

رسم توضيحي لموجة الصوت لـ: المعاملات المتاحة

تتيح واجهة Natiq التحكم الدقيق في مخرجات الصوت عبر معاملات محددة بدقة. يمكنك اختيار نموذج الصوت المناسب لسيناريو IVR أو المكالمات الخارجية، مع ضبط سرعة النطق لتناسب تجربة المتصل.

يتم دعم عدة صيغ صوتية لتتناسب مع أنظمة الهاتف المختلفة. يوفر المعامل الخاص بالسرعة نطاقاً مرناً يسمح بتسريع أو إبطاء الكلام.

النموذج والصوت

يحدد الحقل model محرك توليد الصوت. القيمتان المسمحتان هما tts-1 و tts-1-hd، وكلاهما يستخدمان نفس المحرك وسعر نفس الحرف. لتغيير الصوت، استخدم الحقل voice مع أحد الثماني presets المتاحة (مثل nova للمحادثات السريعة أو atlas للأخبار).

  • النماذج: tts-1 أو tts-1-hd (نفس المحرك والسعر)
  • الأصوات: aria, nova, luna, sage, felix, milo, atlas, orion

صيغة الاستجابة (Response Format)

يحدد الحقل response_format تنسيق الملف الصوتي المُعاد. الخيارات المتاحة هي mp3، wav، opus، flac، و pcm. اختر الصيغة التي تدعمها منصة الـ PBX أو نظام الـ IVR لديك.

سرعة الكلام (Speed)

يتحكم الحقل speed في سرعة النطق، مقبولاً قيماً من 0.25 إلى 4.0. القيمة الافتراضية هي 1.0. لضبط سرعة مناسبة للمكالمات الآلية، يمكنك زيادة السرعة لقص مدة الانتظار أو تقليلها لزيادة الوضوح.

معالجة الأخطاء

رسم توضيحي لموجة الصوت لـ: معالجة الأخطاء

تتبع واجهة API معايير HTTP القياسية للإبلاغ عن حالة كل طلب. يتم إرجاع رمز الحالة 200 عند نجاح التحويل بنجاح، بينما تشير رموز الخطأ مثل 400 إلى بيانات غير صالحة أو 401 عند عدم صحة المفتاح. يساعد هذا في دمج الأخطاء بسهولة في سير عمل البرمجة.

رموز الحالة

يستخدم النظام رموز HTTP المعيارية لتحديد حالة كل عملية. رمز 200 يعني نجاح توليد الصوت، بينما تشير رموز أخرى مثل 400 أو 401 إلى مشاكل في البيانات أو المصادقة. هذا يسهل معالجة الأخطاء ضمن كود البرمجة الخاص بك.

  • 200: نجاح الطلب وإرجاع ملف الصوت.
  • 400: خطأ في صيغة البيانات أو المعاملات.
  • 401: مفتاح API غير صالح أو منتهي الصلاحية.
  • 429: تجاوز حد الطلبات المسموح به.

إرجاع المبالغ في حالة الفشل

إذا فشل الطلب، يتم إرجاع المبلغ الخاص به بالكامل إلى رصيدك. لا يتم خصم تكلفة الطلب الفاشل، مما يضمن دقة الفواتير ويحمي رصيدك من الأخطاء العرضية.

حدود المعدل

رسم توضيحي لموجة الصوت لـ: حدود المعدل

تحدد واجهة API حدود الاستخدام لضمان استقرار الخدمة أثناء توليد الصوت. يعتمد الحساب على مفتاح API النشط لكل حساب، مع تطبيق حد موحد لجميع الطلبات الواردة.

60 طلب في الدقيقة

بمجرد تفعيل المفتاح، يمكنك إرسال ما يصل إلى 60 طلبًا في الدقيقة. يتم معالجة الطلبات بالتسلسل، لذا قد تتأخر بعض الطلبات في قوائم الانتظار أثناء فترات الذروة.

الحدود قبل الإيداع الأول

في المرحلة التجريبية أو قبل أول إيداع رصيد، ينخفض الحد إلى 10 طلبات في الدقيقة فقط. يزداد الحد تلقائيًا إلى 60 طلبًا فور اعتماد الإيداع.

معالجة النصوص الطويلة

رسم توضيحي لموجة الصوت لـ: معالجة النصوص الطويلة

عند معالجة نصوص طويلة لنظام IVR، يجب تقسيم النص المدخل إلى أجزاء لا تتجاوز 4096 حرفاً لكل طلب. هذا الحد ينطبق على النص الكامل بما فيه المسافات والعلامات الترقيمية.

بعد توليد الملفات الصوتية لكل جزء، يقوم المطور بدمجها برمجياً لتكوين ملف صوتي متصل واحد. يتم معالجة الطلبات بالتتابع، لذا قد ينتظر الطلب في الطابور تحت الحمل، لكن السرعة الإجمالية تقترب من الزمن الحقيقي.

تقسيم النص إلى أجزاء

يتم تقسيم النص تلقائياً أو يدوياً لضمان عدم تجاوز حد 4096 حرفاً. كل جزء يُرسل كطلب مستقل بنفس الهيكلية، مع الحفاظ على المعلمات مثل الصوت والسرعة واللغة.

دمج الملفات الصوتية

بعد استلام الاستجابات الصوتية، يتم دمجها باستخدام مكتبة صوتية مناسبة (مثل ffmpeg) لإنشاء ملف واحد متسلسل. تأكد من استخدام نفس صيغة الصوت (مثل wav أو mp3) لجميع الأجزاء لتسهيل الدمج.

  • تأكد من توافق الصيغ الصوتية بين جميع الأجزاء.
  • حافظ على المعلمات الثابتة (الصوت، السرعة، اللغة) عبر الطلبات.
  • قد يستغرق الدمج وقتاً إضافياً قليلاً في الذاكرة.

أصناف الصوتيات

رسم توضيحي لموجة الصوت لـ: أصناف الصوتيات

تتوفر ثمانية أصوات جاهزة مصممة لتغطية مختلف سيناريوهات مراكز الاتصال، من السرد الواضح إلى النبرة الإخبارية المحايدة. كل صوت مبني على تسجيلات مرخصة ويدعم كافة اللغات المدعومة، مما يضمن اتساق جودة الصوت بغض النظر عن لغة النص المدخل.

الدقة والتحكم في السرعة هما المفتاح لضمان وضوح التعليمات في أنظمة IVR. يمكنك اختيار الصوت الذي يناسب هوية علامتك التجارية، مع العلم أن جميع الملفات تحمل علامة مائية صناعية غير مرئية للتمييز بينها وبين التسجيلات البشرية.

قائمة الأصوات الثمانية

تتضمن المجموعة أربعة أصوات نسائية وأربعة ذكور، كل منها يتميز بنبرة محددة:

أصوات نسائية: aria (سردت واضحة)، nova (نبرة مرحة)، luna (سرد قصصي)، sage (تعليمية هادئة).

أصوات ذكور: felix (ترويجي نشيط)، milo (حواري ودود)، atlas (إخباري محايد)، orion (وثائقي عميق).

اللغات المدعومة (23 لغة)

الأصوات تدعم نطق 23 لغة، بما في ذلك العربية والإنجليزية والروسية والصينية والكورية. يمكنك تحديد لغة النص صراحةً عبر الحقل language لتحسين الدقة، خاصة للنصوص المكتوبة بالأحرف اللاتينية غير الإنجليزية.

اللغات المدعومة: العربية، الصينية، الدنماركية، الهولندية، الإنجليزية، الفنلندية، الفرنسية، الألمانية، اليونانية، العبرية، الهندية، الإيطالية، اليابانية، الكورية، الملايوية، النرويجية، البولندية، البرتغالية، الروسية، الإسبانية، السواحيلية، السويدية، التركية.

الأسئلة الشائعة

رسم توضيحي لموجة الصوت لـ: الأسئلة الشائعة

تغطي هذه الأسئلة المتكررة الجوانب العملية لتشغيل الواجهة، من إعداد المفاتيح إلى معالجة البيانات. نقدم إجابات دقيقة لمساعدتك على دمج الخدمة في أنظمة IVR أو المكالمات الخارجية بكفاءة.

تتضمن الإرشادات تفاصيل حول الصيغ المدعومة، نطاقات السرعة، وآليات تحديد اللغة، مما يضمن تحكمًا كاملاً في مخرجات الصوت دون تعقيدات غير ضرورية.

كيف أحصل على مفتاح API؟

أنشئ حسابًا جديدًا في صفحة /get-api-key/ باستخدام Google أو البريد الإلكتروني. بعد التسجيل، سيظهر مفتاح الـ API الخاص بك مع رصيد تجريبي (0.50 دولار) إذا كنت مسجلاً عبر Google.

ما هي صيغة الطلب المطلوبة؟

الطلب يجب أن يكون بصيغة JSON عبر POST إلى https://api.playcv6.com/v1/audio/speech. يتطلب الحقل input للنص، وvoice للاختيار، مع إمكانية تحديد النموذج والصيغة والسرعة.

  • الحقل input للنص (حتى 4096 حرفًا).

هل يمكنني استخدام مكتبة OpenAI؟

نعم، تعمل مكتبات OpenAI الرسمية مع واجهتنا عند تغيير base_url إلى https://api.playcv6.com/v1 واستخدام مفتاح الـ API الخاص بك.

ما هي القيم المسموحة للنموذج؟

القيم المسموحة هي tts-1 و tts-1-hd. كلاهما يستخدم نفس محرك المعالجة والسعر ($10 لكل مليون حرف).

ما هي القيم المسموحة للصوت؟

تتوفر 8 أصوات: aria، nova، luna، sage، felix، milo، atlas، و orion. كل صوت يدعم اللغات الـ 23 المدعومة.

  • aria، nova، luna، sage، felix، milo، atlas، orion.

ما هي الصيغ الصوتية المدعومة؟

يمكنك اختيار mp3، wav، opus، flac، أو pcm عبر الحقل response_format في الطلب.

كيف أحدد لغة النص؟

حدد اللغة باستخدام كود ISO في الحقل language. إذا لم يتم التحديد، سيتم تخمين اللغة (اللاتينية تفترض الإنجليزية افتراضيًا).

ما هو نطاق سرعة الكلام؟

نطاق السرعة هو من 0.25 إلى 4.0. القيم الافتراضية تعطي سرعة طبيعية، ويمكن تعديلها حسب احتياجات نظام IVR.

ماذا يحدث عند تجاوز حد الطلبات؟

الحد هو 60 طلبًا في الدقيقة. قبل أول إيداع، يكون الحد 10 طلبات في الدقيقة. قد تتأخر الطلبات في الطابور تحت الضغط.

هل يتم تخزين النصوص المدخلة؟

يتم استخدام النص فقط لإنتاج الصوت ولا يُستخدم للتدريب. البيانات الوصفية تُحفظ للفوترة، لكن ملف الصوت يُعاد في الاستجابة ولا يُحفظ.

كيف أتعامل مع الأخطاء في الطلب؟

في حالة فشل التوليد، يتم إرجاع المبلغ كاملاً. راجع رموز الحالة في الاستجابة للتعامل مع الأخطاء برمجيًا.

ما هو الحد الأقصى لطول النص؟

الحد الأقصى هو 4096 حرفًا في كل طلب. للنصوص الأطول، قم بتقسيم النص ودمج الملفات الصوتية الناتجة.

هل يمكنني تغيير مفتاح API؟

نعم، يمكنك إصدار مفتاح جديد في أي وقت من لوحة التحكم. سيتوقف المفتاح القديم فورًا عند إصدار الجديد.

كيف أتحقق من الرصيد عبر API؟

يمكنك الاطلاع على الرصيد والرصيد التجريبي وحجم الاستخدام من صفحة /get-api-key/ أو عبر واجهة REST المتاحة.

الأسئلة الشائعة

رسم توضيحي لموجة الصوت لـ: الأسئلة الشائعة

تغطي هذه الأسئلة الشائعة الجوانب العملية لإدارة المفاتيح، حدود الاستخدام، وتكوين الطلبات لضمان تجربة سلسة لمطوري أنظمة IVR. كل إجابة تعتمد على الحقائق التقنية المتاحة في الواجهة دون افتراضات.

تبدأ الإجابات من خطوات الحصول على المفتاح، مروراً بكيفية التعامل مع النصوص الطويلة والأخطاء، وصولاً إلى سياسات الخصوصية وتحديث المفاتيح.

كيف أحصل على مفتاح API؟

يمكنك الحصول على المفتاح عبر صفحة /get-api-key/ باستخدام حساب Google أو البريد الإلكتروني. يمنح تسجيل الدخول بحساب Google رصيداً تجريبياً بقيمة 0.50 دولار (حوالي 50,000 حرف) لمدة 7 أيام. الحسابات المُنشأة بالبريد الإلكتروني تبدأ بدون رصيد تجريبي.

  • تسجيل عبر Google للحصول على رصيد تجريبي فوري.
  • تسجيل بالبريد الإلكتروني يبدأ برصيد صفر.

ما هي صيغة الطلب المطلوبة؟

يتم الإرسال عبر HTTP POST إلى https://api.playcv6.com/v1/audio/speech. يجب أن يكون جسم الطلب بصيغة JSON يحتوي على الحقول المطلوبة مثل model و input و voice.

هل يمكنني استخدام مكتبة OpenAI؟

نعم، الواجهة متوافقة مع شكل طلبات SDK الرسمي لـ OpenAI. فقط قم بتغيير base_url في إعدادات العميل إلى https://api.playcv6.com/v1 واستخدم مفتاح الـ API الخاص بك.

ما هي القيم المسموحة للنموذج؟

القيم المسموحة هي tts-1 و tts-1-hd. كلا النموذجين يستخدمان نفس محرك الصوت ونفس الأسعار.

ما هي القيم المسموحة للصوت؟

تتوفر 8 أصوات: aria، nova، luna، sage (إناث)، و felix، milo، atlas، orion (ذكور). يمكنك اختيار الصوت المناسب لنبرة اتصالك.

ما هي الصيغ الصوتية المدعومة؟

يدعم النظام صيغ: mp3، wav، opus، flac، و pcm. اختر mp3 أو opus لتوفير الحجم، أو wav لجودة عالية غير مضغوطة.

كيف أحدد لغة النص؟

يمكنك تحديد اللغة باستخدام كود ISO اختياري في الطلب. إذا لم تحدد اللغة، سيتم تخمينها بناءً على النص (النص اللاتيني يُفترض أنه إنجليزي افتراضياً). يُنصح بتعيين اللغة يدوياً للنصوص غير الإنجليزية.

ما هو نطاق سرعة الكلام؟

يمكنك ضبط سرعة الكلام من 0.25 إلى 4.0. القيمة 1.0 هي السرعة الطبيعية. هذه الميزة مفيدة جداً لضبط وتيرة الكلام في أنظمة IVR.

ماذا يحدث عند تجاوز حد الطلبات؟

الحد هو 60 طلباً في الدقيقة لكل مفتاح. قبل أول إيداع، الحد هو 10 طلبات في الدقيقة. عند التجاوز، قد يتأخر الطلب أو يتم رفضه.

هل يتم تخزين النصوص المدخلة؟

النص يُستخدم فقط لإنتاج الملف الصوتي ولا يُستخدم للتدريب. الملف الصوتي يُعاد في الاستجابة ولا يُخزن. فقط بيانات الطلب (الوقت، الأحرف، الحالة) تُحفظ للفوترة.

كيف أتعامل مع الأخطاء في الطلب؟

في حال فشل التوليد، يتم إرجاع المبلغ بالكامل. يمكنك التحقق من رموز الحالة (Status Codes) في الاستجابة لتحديد سبب الفشل وإعادة المحاولة إذا لزم الأمر.

ما هو الحد الأقصى لطول النص؟

الحد الأقصى هو 4096 حرفاً لكل طلب. للنصوص الأطول، يجب تقسيمها إلى أجزاء بهذا الحجم ثم دمج الملفات الصوتية الناتجة.

هل يمكنني تغيير مفتاح API؟

نعم، يمكنك إصدار مفتاح جديد في أي وقت من لوحة التحكم. عند إصدار مفتاح جديد، يتوقف العمل بالمفتاح القديم فوراً.

كيف أتحقق من الرصيد عبر API؟

يمكنك الاطلاع على الرصيد، الرصيد التجريبي، والأحرف المتبقية من صفحة /get-api-key/ الخاصة بحسابك، والتي تعرض أيضاً رصيدك الحالي واستهلاكك.

استمع إلى الأصوات الثمانية

تم إنشاء كل عينة أدناه باستخدام هذه الواجهة البرمجية من نفس الجملة. في أنظمة الـ IVR، يعتبر الوضوح الصوتي هو العامل الحاسم في تجربة العميل.

صورة رمزية للصوت aria
ariaأنثى
صورة رمزية للصوت nova
novaأنثى
صورة رمزية للصوت luna
lunaأنثى
صورة رمزية للصوت sage
sageأنثى
صورة رمزية للصوت felix
felixذكر
صورة رمزية للصوت milo
miloذكر
صورة رمزية للصوت atlas
atlasذكر
صورة رمزية للصوت orion
orionذكر

23 لغة

يمكن لأي صوت التحدث بأي من هذه اللغات.

المصادر ومزيد من القراءة

  1. Wikipedia
  2. W3C WAI: making audio and video accessible
  3. TRON developer hub: TRC-20
  4. LibriTTS-R corpus (OpenSLR 141)
  5. MDN: Web Speech API
  6. Creative Commons Attribution 4.0
  7. FFmpeg documentation
  8. Node.js documentation
  9. IETF RFC 7845: Ogg Opus
  10. LibriVox public-domain audiobooks
  11. Tether (USDT)
  12. Python documentation

المزيد في هذا الموقع