الصوت والوقت الفعلي
إنشاء ترجمة
ترجمة الصوت إلى نص باللغة الإنجليزية
نظرة عامة
يقوم بترجمة الصوت بأي لغة مدعومة إلى نص باللغة الإنجليزية. بخلاف التفريغ الصوتي (transcription)، تُرجع نقطة النهاية (endpoint) هذه دائمًا نصًا باللغة الإنجليزية بغض النظر عن لغة الإدخال.
تقوم نقطة النهاية هذه بترجمة الصوت إلى الإنجليزية. لا ترسل language؛ فهي غير مدعومة لترجمة الصوت وقد تُرجع unsupported_parameter. لترجمة النصوص، استخدم POST /v1/translations؛ حيث تشير recommended_for=translation إلى ذلك الـ API المخصص للنصوص.
محتوى الطلب (Request Body)
يتم إرجاع الترجمة عند اكتمال المعالجة. بالنسبة للملفات الصوتية الأطول، يُرجى ضبط مهلة عميل HTTP (client timeout) على 120s على الأقل.
الملف الصوتي المراد ترجمته. التنسيقات المدعومة: flac، mp3، mp4، mpeg، mpga، m4a، ogg، wav، webm. أقصى حجم للملف هو 25 ميجابايت.
لا يوجد نموذج عام يعلن حاليًا عن دعمه لـ POST /v1/audio/translations؛ لا يوجد معرف نموذج افتراضي أو قابل للنسخ.
نص اختياري لتوجيه أسلوب النموذج أو متابعة مقطع سابق. يجب أن يكون باللغة الإنجليزية.
jsonتنسيق الإخراج. تعتمد القيم المقبولة على النموذج؛ يرجى مراجعة تفاصيله. يُرجع text نصًا خامًا بدلاً من كائن JSON.
درجة حرارة أخذ العينات (Sampling temperature) من 0 إلى 1، فقط للنماذج التي تسرد هذه المعلمة.
الاستجابة
تصف الحقول أدناه استجابات JSON الخاصة بالتفريغ أو الترجمة. تُرجع text و srt و vtt نصًا خامًا أو ملفات ترجمة نصية بدلاً من كائن JSON. تعتمد الحقول الإضافية على النموذج وتنسيق الإخراج.
النص المترجم باللغة الإنجليزية.
بالنسبة لتنسيق verbose_json، تتضمن الاستجابة أيضًا:
تسمية اللغة المحددة في الاستجابة، عند توفرها.
مدة الصوت المدخل بالثواني.
مقاطع من النص المترجم مصحوبة بطوابع زمنية.
الطلب
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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.
القيم المتاحة
- "auto"
- "verified"
- "official"
جسم الطلب
multipart/form-data
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json