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

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

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

تغطي هذه الوثيقة الهيكل البرمجي لطلبات HTTP، وتوضيح كيفية استخدام مكتبات OpenAI المعروفة عبر تغيير عنوان URL الأساسي. كما تُفصّل الصيغ الصوتية المدعومة، وإعدادات السرعة واللغة، وآلية التعامل مع الأخطاء والحدود الزمنية لضمان تكامل موثوق وفعال.

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

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

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

سجّل حسابك عبر صفحة /get-api-key/ باستخدام جوجل أو البريد الإلكتروني. بعد التسجيل، ستظهر لك صفحة تحتوي على مفتاح API النشط، رصيدك، وتاريخ الاستخدام. يمكنك إصدار مفتاح جديد في أي وقت، حيث يتوقف المفتاح القديم فوراً. هذا الإجراء مخصص لمطوري التطبيقات المستقلين لدمج الخدمة في مشاريعهم.

ما هو نموذج cURL الأولي؟

الطلب الأساسي هو POST إلى https://api.k111.info/v1/audio/speech. يجب أن يحتوي الجسم على الحقل 'model' (مثل tts-1)، و'input' للنص، و'voice' لاختيار الصوت، و'response_format' للصيغة المطلوبة. استخدم رأس Authorization مع مفتاحك: 'Bearer tts-...'. سيتم إرجاع ملف صوتي مباشرة في استجابة الخادم عند نجاح العملية.

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

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

ما هي نقاط النهاية المتاحة؟

النقاط المتاحة هي: POST /v1/audio/speech لتوليد الصوت، GET /v1/voices للحصول على تفاصيل الأصوات واللغات والصيغ والأسعار، وGET /v1/models لعرض النماذج المدعومة. جميع النقاط تعمل ضمن النطاق https://api.k111.info/v1. استخدم النقاط المناسبة حسب احتياجك في دورة حياة تطبيقك.

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

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

ما الفرق بين tts-1 و tts-1-hd؟

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

هل يتساوى السعر بين النموذجين؟

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

كيف أتحكم في سرعة القراءة؟

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

ما هو الحد الأقصى للأحرف في الطلب؟

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

ما هو حد الطلبات في الدقيقة؟

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

كيف أعرف أن الطلب قد فشل؟

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

هل يتم إرجاع الرصيد عند الفشل؟

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

كيف يتم تحديد اللغة تلقائياً؟

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

ما هي نقاط النهاية الأخرى المتاحة؟

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

الطلب الأول

curl

curl https://api.k111.info/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.k111.info/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.k111.info/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

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

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

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

انتقل إلى صفحة /get-api-key/ وانقر على زر التسجيل. يدعم النظام المصادقة عبر Google لإصدار الرصيد التجريبي تلقائياً، أو التسجيل التقليدي بالبريد الإلكتروني. يُنشأ الحساب على الموقع المستقل فقط.

  • التسجيل عبر Google يمنح رصيداً تجريبياً لمدة 7 أيام.
  • التسجيل بالبريد الإلكتروني لا يتضمن رصيداً تجريبياً تلقائياً.

الوصول إلى لوحة التحكم

الوصول إلى لوحة التحكم

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

نسخ مفتاح الوصول

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

  • مفتاح واحد نشط لكل حساب.
  • إصدار مفتاح جديد يوقف القديم فوراً.

أول طلب برمجى

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

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

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

مثال طلب cURL

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

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

  • curl -X POST https://api.k111.info/v1/audio/speech
  • -H "Authorization: Bearer tts-your-key"
  • -H "Content-Type: application/json"
  • -d '{"model": "tts-1", "input": "مرحباً", "voice": "aria"}'

هيكل الطلب JSON

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

تحدد حقل response_format المخرجات بين MP3، WAV، OPUS، FLAC، أو PCM. لا توجد حقول اختيارية معقدة مثل SSML، مما يبسط بنية الطلب ويقلل احتمالية الخطأ في التنسيق.

  • model: "tts-1" أو "tts-1-hd"
  • input: النص (حد 4096 حرف)
  • voice: اسم الصوت المحدد
  • response_format: mp3, wav, opus, flac, pcm

المصادقة باستخدام المفتاح

يتم التوثيق عبر رأس HTTP Authorization بقيمة Bearer متبوعة بمفتاح API الخاص بالحساب. يجب نسخ المفتاح من لوحة التحكم بعد التسجيل، حيث يميز كل حساب بمفتاح فريد نشط واحد.

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

  • H "Authorization: Bearer tts-xxxxxxxxxx"
  • مفتاح واحد نشط لكل حساب
  • إصدار مفتاح جديد يلغي القديم فوراً

التكامل مع مكتبات OpenAI

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

تتطلب التكامل مع واجهة كلام تك تعديل عنوان URL الأساسي في مكتبات OpenAI المفتوحة المصدر. هذا التغيير يسمح للـ SDK بالاتصال مباشرة بالخادم الخاص بنا دون الحاجة إلى تعديل هيكل الطلبات أو استيراد مكتبات جديدة.

باستخدام هذا الإعداد، يمكنك إرسال نصوص إلى نقطة النهاية /v1/audio/speech والحصول على ملفات صوتية بتنسيقات متعددة. تظل هياكل الطلبات متوافقة تماماً مع المواصفات المعروفة، مما يسهل الانتقال من بيئات الاختبار إلى الإنتاج.

تغيير عنوان URL الأساسي

لإعداد الاتصال الصحيح، قم بتعيين متغير البيئة OPENAI_BASE_URL إلى https://api.k111.info/v1 أو مرره مباشرة في إعدادات العميل. هذا يوجه جميع الطلبات المرسلة عبر SDK إلى البنية التحتية الخاصة بكلام تك.

استخدام SDK الرسمي

يمكنك استخدام إصدارات OpenAI SDK المعتمدة (Python, Node.js, etc.) كما هي. فقط تأكد من تمرير مفتاح API الخاص بك عبر OPENAI_API_KEY. لا حاجة لتعديل كود التطبيق الأساسي سوى تغيير نقطة النهاية.

  • يدعم Python و JavaScript و Go و Rust
  • متوافق مع هيكل طلبات OpenAI التقياسي
  • لا يتطلب تراخيص إضافية أو اعتماديات خاصة

نقاط النهاية المتاحة

تتوفر ثلاث نقاط نهاية رئيسية: /v1/audio/speech لتوليد الصوت، /v1/voices للحصول على قائمة الأصوات المدعومة ومعلوماتها، و /v1/models للتحقق من الطرازات المتاحة. جميعها تعمل ضمن نفس نطاق API الأساسي.

  • POST /v1/audio/speech: توليد الصوت
  • GET /v1/voices: قائمة الأصوات
  • GET /v1/models: الطرازات المتاحة

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

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

تحدد حقل response_format في الطلب نوع الملف الصوتي المستلم. تدعم الواجهة خمس صيغ مختلفة تناسب احتياجات التخزين والأداء المتنوعة في تطبيقاتك.

تختلف الصيغ في نسبة الضغط وجودة الصوت وحجم الملف النهائي. اختر الصيغة التي تتوافق مع قيود النطاق الترددي وحاجة التطبيق إلى سرعة التحميل.

صيغة MP3

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

  • حجم ملف صغير نسبياً
  • متوافق مع معظم المشغلات والمتصفحات
  • مناسبة لنقل البيانات عبر الشبكات

صيغة WAV

تقدم جودة صوت غير مضغوطة. مناسبة للمشاريع التي تتطلب أعلى دقة صوتية دون ضغط البيانات.

  • جودة عالية غير مضغوطة
  • حجم ملف كبير
  • مناسبة للمشاريع الصوتية الاحترافية

صيغ OPUS و FLAC و PCM

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

  • OPUS: ضغط عالي للبث
  • FLAC: ضغط بدون فقدان الجودة
  • PCM: بيانات صوتية خام

نموذج الصوت والطراز

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

يحدد الحقل model في جسم الطلب الطراز المستخدم لتوليف الصوت. يتوفر خياران رئيسيان، كلاهما يعتمد على نفس المحرك الأساسي لتقديم جودة صوتية متسقة.

نموذج tts-1

يُمثل هذا الطراز الخيار الأساسي لتوليف النص. يُستخدم عبر تحديد الحقل model بالقيمة "tts-1" في طلبات API.

نموذج tts-1-hd

نسخة عالية الدقة من نفس المحرك الأساسي. يُحدد باستخدام القيمة "tts-1-hd" في حقل الطراز.

التساوي في السعر والأداء

كلا الطرازين يستندان إلى نفس محرك التوليف، مما يعني أن جودة الصوت متطابقة تقريباً. كما أن آلية التسعير موحدة، فلا فرق في التكلفة بين استخدام tts-1 أو tts-1-hd.

نموذج الصوت والطراز

إعدادات الطلب الإضافية

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

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

تحديد سرعة القراءة

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

  • النطاق المسموح: 0.25 إلى 4.0
  • القيمة الافتراضية: 1.0
  • لا تؤثر السرعة على السعر أو النموذج

تحديد اللغة يدوياً

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

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

تحديد الصوت المطلوب

حدد الصوت عبر الحقل voice باستخدام أحد الأسماء الثمانية المتاحة. تنوع الأصوات (ذكور وإناث) يسمح باختيار نبرة تناسب نوع المحتوى، من السردي إلى الإخباري. يمكنك مراجعة القائمة الكاملة عبر endpoint GET /v1/voices.

  • الأصوات المتاحة: 8 خيارات
  • الأصوات النسائية: aria, nova, luna, sage
  • الأصوات الذكورية: felix, milo, atlas, orion

معالجة الأخطاء والحدود

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

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

تتغير السرعة حسب حجم النص؛ فالنصوص الطويلة تُعالج بسرعة تقارب الوقت الفعلي (حوالي 25 حرفاً في الثانية)، بينما قد تستغرق الجمل القصيرة بضع ثوانٍ إضافية. تُعالج الطلبات بالتتابع، مما يعني احتمال ظهور طابور انتظار تحت الضغط، لذا يُنصح بتجنب إرسال طلبات متزامنة كثيفة دون تنظيم.

حد الطلبات الدقيقة

يتم تقييد الوصول بناءً على مفتاح المصادقة الفريد. قبل الشحن الأول، يُسمح بـ 10 طلبات فقط في الدقيقة، وبعد الشحن يرتفع الحد إلى 60 طلباً في الدقيقة. تجاوز هذا الحد يؤدي إلى رفض الطلبات.

  • 60 طلب/دقيقة بعد الشحن الأول
  • 10 طلبات/دقيقة قبل الشحن
  • الحد يتم حسابه لكل مفتاح API على حدة

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

الخطأ الأكثر شيوعاً هو تجاوز حد الأحرف (4096 حرفاً لكل طلب). أيضاً، قد يؤدي عدم تحديد اللغة للنصوص غير الإنجليزية المكتوبة بالأح اللاتينية إلى توقع خاطئ للنطق. تأكد من استخدام النص المدعوم والصيغ المدفوعة.

  • تجاوز حد 4096 حرفاً في الطلب الواحد
  • عدم تحديد اللغة للنصوص غير الإنجليزية
  • استخدام صوت غير موجود أو تنسيق غير مدعوم

إعادة المحاولة عند الفشل

إذا فشل الطلب لأسباب مؤقتة (مثل التأخير في الطابور)، يتم إرجاع الرصيد بالكامل. لا تتكبد تكلفة للطلب الفاشل. يُنصح بتطبيق استراتيجية إعادة المحاولة مع زيادة الفجوة الزمنية (Exponential Backoff) بين المحاولات لتجنب ازدحام الخادم.

  • إرجاع كامل للرصيد في حال فشل الطلب (يتم إرجاع المبلغ بالكامل)
  • تطبيق استراتيجية إعادة المحاولة مع تأخير متزايد
  • التحقق من حالة الطلب عبر الرموز التعريفية

نصائح للمطورين المستقلين

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

يحتاج المطورون المستقلون إلى فهم كيفية استهلاك الرصيد بدقة لتجنب نفاد الأموال أثناء تشغيل التطبيقات. يوفر النظام حسابًا تجريبيًا بقيمة 0.50 دولار لـ 50000 حرف لمدة 7 أيام عند التسجيل عبر جوجل، مما يتيح اختبار التكامل دون تكلفة فورية.

بمعدل تكلفة 0.01 دولار لكل 1000 حرف، يمكن حساب التكلفة المتوقعة لكل مشروع بدقة. يُنصح بمراقبة استخدام النص بانتظام عبر لوحة التحكم لضمان استمرارية الخدمة دون مفاجآت مالية.

إدارة الرصيد بكفاءة

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

لا توجد اشتراكات شهرية أو حد أدنى للإنفاق. الرصيد لا ينتهي، ويمكن إضافة USDT (TRC-20) بأي مبلغ يبدأ من 5 دولارات، مع اعتماد الرصيد تلقائيًا خلال دقائق.

  • التسجيل بجوجل يمنح 0.50 دولار تجريبي لمدة 7 أيام
  • حد السرعة يبدأ بـ 10 طلبات/دقيقة حتى أول إضافة رصيد
  • الحد الأقصى 60 طلبًا في الدقيقة لكل مفتاح

تقسيم النصوص الطويلة

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

قم بدمج الملفات الصوتية الناتجة برمجيًا بعد استلامها. لا توجد ميزة دعم للترابط التلقائي أو السلسلة في الواجهة الأساسية.

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

اختبار الأداء قبل النشر

سرعة التوليد تتراوح تقريبًا بين ثانية واحدة لكل 25 حرفًا للنصوص الطويلة. قد تنتظر الطلبات في الطابور تحت الحمل العالي، لذا اختبر زمن الاستجابة في ظروف شبكتك.

تأكد من أن مفتاح API يعمل ضمن نطاق السرعة المسموح به قبل إطلاق التطبيق للمستخدمين النهائيين لتجنب تأخير تجربة المستخدم.

  • سرعة توليد تقريبية: 25 حرفًا في الثانية
  • الطلبات تُعالج بالترتيب وقد تنتظر في الطابور
  • اختبار التأخير تحت حمل حقيقي ضروري

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

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

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

23 لغة

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

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

  1. Wikipedia
  2. LibriVox public-domain audiobooks
  3. Python documentation
  4. IETF RFC 7845: Ogg Opus
  5. LibriTTS-R corpus (OpenSLR 141)
  6. curl documentation
  7. FFmpeg documentation
  8. LibriTTS-R paper (arXiv 2305.18802)
  9. openai-node on GitHub
  10. Tether (USDT)
  11. ISO 639 language codes
  12. openai-python on GitHub

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