تجريبي
ابدأ باستخدام واجهة الصوت العربي
تصفّح التوثيق
من الحساب إلى أول طلب
- أنشئ حسابًا، ثم أنشئ مفتاحًا من صفحة مفاتيح الواجهة. احفظه على الخادم؛ لا تضعه في كود المتصفح أو المستودع. مفاتيح الواجهة
- اختر صوتًا من المكتبة. يستخدم المثال أدناه معرّف صوت عام متاح، إن وُجد؛ ويمكنك استبداله بمعرّف صوتك. مكتبة الأصوات
- لأمثلة Python ثبّت حزمة openai باستخدام pip install openai، أو استخدم npm install openai لمثال Node.js. استبدل المفتاح التجريبي بمفتاحك قبل الإرسال.
curl --fail --show-error https://api.sawtakarabi.ai/v1/audio/speech \
-H "Authorization: Bearer sk_ar_live_..." \
-H "Content-Type: application/json" \
-d '{"model":"arabic tts","input":"مرحبا بك","voice":"9287b630-bc5f-574d-8c38-5f525c2b4ca3","response_format":"pcm"}' \
--output speech.pcmالناتج صوت PCM خام، وليس ملف WAV. راجع توثيق البث لتشغيله. يتطلب الطلب رصيدًا متاحًا؛ ولا يعني نجاح المصادقة أن التوليد سيكتمل إذا كانت الخدمة غير متاحة.
شغّل المثال واستمع إلى النتيجة
اختر لغة واحدة من الأمثلة أعلاه. نفّذ أمر curl في الطرفية، أو احفظ مثال Python في speech.py وشغّله باستخدام python speech.py. لمثال Node.js، احفظ الملف باسم speech.mjs ثم نفّذ node speech.mjs؛ فهذا المثال يستخدم import وawait خارج الدوال.
بعد نجاح الطلب، ستجد speech.pcm في المجلد الذي شغّلت منه المثال. إذا كان FFmpeg مثبتًا، شغّل الصوت بالأمر التالي. تستخدم الأمثلة معدل الإخراج الافتراضي، ٢٤٠٠٠ هرتز.
ffplay -f s16le -ar 24000 -ac 1 speech.pcmإذا لم يكتمل الطلب
تحقّق من رمز HTTP: يشير 401 إلى مشكلة في المفتاح، و402 إلى عدم كفاية الرصيد، و404 إلى صوت غير موجود أو غير متاح لحسابك. عند 429 أو 503، انتظر قبل إعادة المحاولة وزِد مدة الانتظار تدريجيًا. لا تشغّل ملفًا قديمًا من طلب سابق على أنه نتيجة الطلب الجديد.