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

إنشاء ترجمة

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

POST
/v1/audio/translations

نظرة عامة

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

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

محتوى الطلب (Request Body)

يتم إرجاع الترجمة عند اكتمال المعالجة. بالنسبة للملفات الصوتية الأطول، يُرجى ضبط مهلة عميل HTTP (client timeout) على 120s على الأقل.

filefileمطلوب

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

modelstringمطلوب

لا يوجد نموذج عام يعلن حاليًا عن دعمه لـ POST /v1/audio/translations؛ لا يوجد معرف نموذج افتراضي أو قابل للنسخ.

promptstring

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

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

تنسيق الإخراج. تعتمد القيم المقبولة على النموذج؛ يرجى مراجعة تفاصيله. يُرجع text نصًا خامًا بدلاً من كائن JSON.

temperaturenumber

درجة حرارة أخذ العينات (Sampling temperature) من 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 "model=your-model-id" \
  -F "file=@german_audio.mp3"

الاستجابة

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

الترجمة مقابل التفريغ الصوتي

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

التفويض

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