نسخ الصوت
قم بتوفير الصوت بتنسيق base64 في input_audio.data وصيغته الفعلية.
في هذه الصفحة
https://api.shareai.now/api/v1/audio/transcriptionsنسخ الصوت
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_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"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);يحتوي المثال على ملف 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.
رابط إلى وحدات الفوترة