الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
audio
/
translations
curl -X POST "https://api.lemondata.cc/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?"
}

​
نظرة عامة

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

​
جسم الطلب (Request Body)

​
file
file
مطلوب
ملف الصوت المراد ترجمته. التنسيقات المدعومة: flac، mp3، mp4، mpeg، mpga، m4a، ogg، wav، webm. الحد الأقصى لحجم الملف هو 25 ميجابايت.
​
model
string
افتراضي:"whisper-1"
النموذج المستخدم. حاليًا، يتم دعم whisper-1 فقط.
​
prompt
string
نص اختياري لتوجيه أسلوب النموذج أو إكمال مقطع سابق. يجب أن يكون باللغة الإنجليزية.
​
response_format
string
افتراضي:"json"
تنسيق المخرجات. الخيارات: json، text، srt، verbose_json، vtt.
​
temperature
number
درجة حرارة العينات (sampling temperature)، بين 0 و 1. القيم الأعلى مثل 0.8 تؤدي إلى مخرجات أكثر عشوائية، بينما القيم الأقل مثل 0.2 تجعل المخرجات أكثر تركيزًا وحتمية.

​
الاستجابة (Response)

​
text
string
النص المترجم باللغة الإنجليزية.
بالنسبة لتنسيق verbose_json، تتضمن الاستجابة أيضًا:
​
language
string
اللغة المكتشفة للصوت المدخل.
​
duration
number
مدة الصوت المدخل بالثواني.
​
segments
array
مقاطع من النص المترجم مع طوابع زمنية.
curl -X POST "https://api.lemondata.cc/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?"
}

​
الترجمة مقابل التفريغ الصوتي (Translation vs Transcription)

الميزةالترجمة (Translation)التفريغ الصوتي (Transcription)
لغة المخرجاتدائمًا الإنجليزيةنفس لغة الإدخال
حالة الاستخدامتحويل الصوت الأجنبي إلى الإنجليزيةالحفاظ على اللغة الأصلية
معلمة اللغة (language)غير قابلة للتطبيقتلميح اختياري
يقوم مسار الترجمة (translation endpoint) تلقائيًا باكتشاف لغة المصدر والترجمة إلى الإنجليزية. يتم تجاهل معلمة language المستخدمة في التفريغ الصوتي.