TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

الصوت والوقت الفعلي

إنشاء ترجمة

يترجم الصوت إلى نص باللغة الإنجليزية

POST
/v1/audio/translations

نظرة عامة

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

تترجم نقطة النهاية هذه الصوت إلى الإنجليزية. لا ترسل language؛ فهي غير مدعومة لترجمة الصوت وقد تُرجع unsupported_parameter. لترجمة النص، استخدم POST /v1/translations؛ وتشير recommended_for=translation إلى واجهة النص هذه.

نص الطلب

تعود الاستجابة بعد انتهاء الترجمة. للصوت الطويل، اضبط مهلة عميل HTTP على 120s على الأقل.

filefileمطلوب

ملف الصوت المراد ترجمته. التنسيقات المدعومة: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. الحد الأقصى لحجم الملف هو 25 MB.

modelstringالافتراضي: whisper-1

معرّف نموذج ترجمة الصوت، مثل whisper-1. تأكد من دعمه لـ POST /v1/audio/translations في تفاصيله الحالية.

promptstring

نص اختياري لتوجيه أسلوب النموذج أو لمتابعة مقطع سابق. يجب أن يكون باللغة الإنجليزية.

response_formatstringالافتراضي: json

تنسيق الإخراج. يدعم Whisper القيم json وtext وsrt وverbose_json وvtt. قد تختلف التنسيقات في النماذج الأخرى؛ راجع تفاصيل النموذج.

temperaturenumber

درجة حرارة أخذ العينات من 0 إلى 1، للنماذج التي تدعم هذه المعلمة فقط.

الاستجابة

تصف الحقول التالية استجابات JSON للتفريغ أو الترجمة. تعيد text وsrt وvtt نصًا أو ترجمة مصاحبة خامًا بدلاً من كائن JSON. تعتمد الحقول الإضافية على النموذج وتنسيق الإخراج.

textstring

النص المترجم باللغة الإنجليزية.

بالنسبة إلى تنسيق verbose_json، تتضمن الاستجابة أيضًا:

languagestring

وسم اللغة الوارد في الاستجابة، عند توفره.

durationnumber

مدة الصوت المُدخل بالثواني.

segmentsarray

مقاطع من النص المترجم مع الطوابع الزمنية.

الطلب

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@german_audio.mp3" \
  -F "model=whisper-1"

الاستجابة

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

الترجمة مقابل النسخ

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

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

multipart/form-data

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

إنشاء تفريغ صوتي

السابق

Realtime WebSocket

التالي