ShareAI Platform Docs

نسخ الصوت

قم بتوفير الصوت بتنسيق base64 في input_audio.data وصيغته الفعلية.

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

نسخ الصوت

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

توفير الصوت بصيغة base64 في input_audio.data وبياناته الفعلية format. تعتمد اللغات المدعومة، المطالبات، تنسيقات الاستجابة وخيارات الطابع الزمني على النموذج. لا يقبل هذا الـ JSON endpoint تحميل ملفات متعددة الأجزاء. تحتوي الاستجابة على النص المفرغ والاستخدام المبلغ عنه.

قبل أن تبدأ#

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

إرسال طلب#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
  "input_audio": {
    "data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "format": "wav"
  }
}'

يحتوي المثال على ملف WAV صغير وصامت فقط لإظهار نقل base64 صالح. استبدل input_audio.data بـ base64 القياسي لملف الصوت الخاص بك؛ لاستخدام Python استخدم base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). لا تلصق رابط صوت في هذا الحقل.

حقول الطلب#

الحقلالنوعمطلوب
model سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.استعلام ذو صلة غير فارغ.
input_audio سلسلة نصيةتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.الحقول والبيانات المطلوبة. data هي base64 القياسي لبايتات الصوت الفعلية؛ يجب أن يتطابق التنسيق. JSON فقط؛ تحميل ملفات متعددة الأجزاء غير مدعوم. تتطلب تعريفات التعرفة الزمنية ملفات WAV أو MP3 أو FLAC مع قاعدة زمنية معروفة، بحد أقصى 600 ثانية مجتمعة.
languageمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.رمز اللغة المدعوم من النموذج (اختياري).
promptمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.سياق التفريغ المدعوم من النموذج (اختياري)؛ ليس مطالبة لتوليد الصوت.
response_formatمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.صيغة الرد المدعومة من النموذج، بحد أقصى 100 حرف. تحدد العملية ما إذا كانت النتيجة JSON أو ثنائية.
timestamp_granularitiesمصفوفةقيم دقة الطابع الزمني المدعومة من النموذج (اختياري). تعتمد الإتاحة على تنسيق الاستجابة والنموذج.
providerتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،.

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

النجاح يعيد HTTP 200 مع JSON. توفير الصوت بصيغة base64 في input_audio.data وبياناته الفعلية format. تعتمد اللغات المدعومة، المطالبات، تنسيقات الاستجابة وخيارات الطابع الزمني على النموذج. لا يقبل هذا الـ JSON endpoint تحميل ملفات متعددة الأجزاء. تحتوي الاستجابة على النص المفرغ والاستخدام المبلغ عنه.

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

يستخدم التفريغ تعريفات التعرفة الزمنية و/أو الرمزية المنشورة للنموذج. تظل الثواني والرموز المبلغ عنها من قبل Provider قياسات منفصلة. طول base64 ليس مدة الصوت أو عدد الرموز. تتطلب تعريفات التعرفة الزمنية إدخال ملفات WAV أو MP3 أو FLAC ذات مدة مجتمعة لا تزيد عن 600 ثانية؛ القواعد الزمنية غير المعروفة أو PCM الخام غير مقبولة لتسعير المدة.

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

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

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

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

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

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI