ShareAI Platform Docs

إنشاء الكلام

الاستجابة الناجحة هي صوت ثنائي، وليس JSON.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/audio/speech

إنشاء الكلام

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
النطاق المطلوب
inference or monetization_gateway

الاستجابة الناجحة هي صوت ثنائي، وليس JSON. احفظه باستخدام curl --output speech.mp3 أو اقرأ بايتات الاستجابة في SDK الخاص بك. اختر صوت نموذج مدعومًا وصيغة إخراج؛ السرعة محدودة بين 0.25 و 4. الحد الأقصى للإدخال هو 256 KiB وحد الاستجابة المتزامنة هو 2 MiB.

قبل أن تبدأ#

المعنى والحدود.

إرسال طلب#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_SPEECH_MODEL",
  "input": "Hello from ShareAI.",
  "response_format": "mp3"
}' --output speech.mp3

حقول الطلب#

الحقلالنوعمطلوب
model سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.استعلام ذو صلة غير فارغ.
input سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.نص الكلام المطلوب غير فارغ، بحد أقصى 256 KiB من UTF-8. يتم احتساب التعريفات بناءً على أحرف Unicode، وليس البايتات المشفرة.
voiceمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.صوت اختياري مدعوم من نموذج الكلام المحدد، بحد أقصى 100 حرف.
response_formatمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.ترميز صوتي اختياري مدعوم مثل mp3. الاستجابة الناجحة هي ثنائية، وليست JSON. المسارات المسعرة حسب المدة تحتاج إلى MP3 أو WAV أو FLAC ذات وصف ذاتي.
speedرقمسرعة الكلام الاختيارية من 0.25 إلى 4؛ قد يفرض النموذج حدودًا أضيق.
providerتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،.

قراءة النتيجة#

النجاح يعيد HTTP 200 مع صوت ثنائي. الاستجابة الناجحة هي صوت ثنائي، وليس JSON. احفظه باستخدام curl --output speech.mp3 أو اقرأ بايتات الاستجابة في SDK الخاص بك. اختر صوت نموذج مدعومًا وصيغة إخراج؛ السرعة محدودة بين 0.25 و 4. الحد الأقصى للإدخال هو 256 KiB وحد الاستجابة المتزامنة هو 2 MiB.

وحدات الفوترة#

يمكن تسعير الكلام حسب عدد الأحرف المدخلة، أو الرموز المبلغ عنها من قبل المزود، أو الثانية المولدة، حسب النموذج. يتم احتساب عدد الأحرف باستخدام أحرف Unicode. تسعير المدة يتطلب نتيجة MP3 أو WAV أو FLAC ذات وصف ذاتي مدعومة. نتيجة PCM الخام ليس لها معدل عينة مُخمن. المسارات المسعرة حسب الرموز تحتاج إلى إيصال استخدام موثوق.

يتم نشر الأسعار بعملة EUR AI credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.

التسعير والاستخدام#

لتوجيه تكلفة الشبكة المعتمدة أو.

الوصول والأخطاء#

استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.

رابط إلى وحدات الفوترة

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI