الترجمة

يفرّغ transcript1 الوسائط أولًا، ثم يترجم نص التفريغ إلى لغة تختارها. تُحاذى الترجمة لكل مقطع وتحافظ على الأوقات والمتحدثين الأصليين. هي ترجمة نصية فقط: لا دبلجة ولا صوت مترجم.

الترجمة مجانية. تستخدم 0 دقيقة وتظهر في سجل الاستخدام كبند مجاني باسم "Translation". تُحتسب دقائق التفريغ كالمعتاد، ولا يتسبب فشل الترجمة أبدًا في فشل النص المفرغ ولا في استرداده.

الترجمة أثناء التفريغ

أضف translate_to إلى الطلب الذي ينشئ التفريغ. وهو رمز ISO 639-1 من حرفين صغيرين، مثل es أو en. يعمل مع رابط فيديو في جسم JSON لطلب POST /v1/transcriptions، ومع حجز رفع على أجزاء، ومع رفع multipart من خطوة واحدة.

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

عند رفع ملف، أرسل translate_to حقلًا في النموذج:

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

تقبل أداة MCP transcribe المعامل translate_to أيضًا. لغة هدف واحدة لكل طلب.

ترجمة نص مفرغ موجود

اطلب ترجمة تفريغ مكتمل:

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

يرد API بالرمز 202:

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}

الاستدعاء idempotent. تُعاد الترجمة ذات الحالة processing أو completed كما هي، وتُعاد محاولة الترجمة failed. تقبل أداة MCP translate_transcription المعاملين id وlanguage.

قراءة الترجمة

يقبل GET /v1/transcriptions/:id وتنزيلات النص وSRT وVTT المعامل translation:

يتضمن الرد كائن translation، أو null إذا لم تُطلب ترجمة:

{
  "translation": { "language": "es", "status": "completed" }
}

قيمة status هي processing أو completed أو failed. وتتضمن الترجمة الفاشلة رسالة error أيضًا. ينتظر wait الترجمة المطلوبة كذلك؛ وعند انتهاء المهلة تكون الحالة processing. لأداة MCP get_transcription معامل translation بالقيم نفسها.

Webhooks

يبلغ حدثان بنتيجة الترجمة، إضافة إلى transcription.completed وtranscription.failed اللذين لم يتغيرا:

data هو كائن التفريغ مضافًا إليه translation: { language, status, error }. تجد التواقيع وقواعد التسليم في Webhooks.