تخطّي إلى المحتوى

Workflow Utilities Auto Subtitle

التكامل

معرّف النموذج workflow-utilities/auto-subtitle
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/workflow-utilities/auto-subtitle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.005 $⁩ 5 أرصدة API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Utility · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب video_url
أفلت ملفًا، أو

عنوان URL لفيديو لإضافة ترجمات تلقائية.

متقدم font_weight · position · language · font_name · font_color · highlight_color · stroke_color · background_color · font_size · stroke_width · background_opacity · y_offset · words_per_subtitle · enable_animation
font_weight الافتراضي bold

سماكة النص؛ يستخدم تنسيق TikTok عادةً bold أو black.

position الافتراضي bottom

موضع الترجمة على المحور الرأسي.

الافتراضي en

معرّف لغة النسخ، مثل 'en' أو 'es' أو 'fr' أو 'de' أو 'it' أو 'pt' أو 'nl' أو 'ja' أو 'zh' أو 'ko'. ويُقبل أيضًا معرّف ISO من 3 أحرف مثل 'eng' أو 'spa' أو 'fra'.

الافتراضي Montserrat

اسم الخط المختار من fonts.google.com؛ يُقبل أي Google Font، بما في ذلك 'Montserrat' و'Poppins' و'BBH Sans Hegarty'.

الافتراضي white

اللون المستخدم لكلمات الترجمة غير النشطة.

الافتراضي purple

لون التمييز بنمط الكاريوكي المطبق على الكلمة المنطوقة.

الافتراضي black

اللون المطبق على مخطط النص أو حدّه.

الافتراضي none

لون الخلفية خلف النص؛ يعطّل 'none' و'transparent' الخلفية معًا.

الافتراضي 100

حجم خط الترجمة؛ يستخدم تنسيق TikTok نصًا أكبر.

الافتراضي 3

عرض مخطط النص أو حدّه، مقاسًا بالبكسل؛ تعطل القيمة 0 ذلك.

الافتراضي 0

شفافية الخلفية، حيث تعني 0.0 شفافية كاملة و1.0 عتامة كاملة.

الافتراضي 75

الإزاحة الرأسية بالبكسل؛ تحرّك القيم الموجبة النص إلى الأسفل، بينما تحرّكه القيم السالبة إلى الأعلى.

الافتراضي 3

الحد الأقصى لعدد كلمات الترجمة، ما يسمح بعرض كلمة واحدة عند 1، أو عبارة قصيرة عند 2–3، أو جملة كاملة عند 8–12 كلمة لكل مقطع.

POST /run/workflow-utilities/auto-subtitle?wait=20 عرض السعر → ⁨‏0.005 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/workflow-utilities/auto-subtitle?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Workflow Utilities Auto Subtitle

يفرّغ الكلام في الفيديو ويحرق ترجمات مع إبراز الكلمة المنطوقة حاليًا. تشمل خيارات التنسيق أي اسم Google Font، وحجمًا من 20-150، والوزن، وألوان النص والإبراز، والحد، ولون الخلفية وشفافيتها، والموضع العلوي أو الأوسط أو السفلي مع إزاحة عمودية. تتراوح `words_per_subtitle` من 1 إلى 12، ويمكن تشغيل حركة ارتداد أو إيقافها. كما يعيد التفريغ والتوقيتات الخاصة بالكلمات.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو لإضافة ترجمات تلقائية.
languageاختياري
النوعstring
الافتراضيen
معرّف لغة النسخ، مثل 'en' أو 'es' أو 'fr' أو 'de' أو 'it' أو 'pt' أو 'nl' أو 'ja' أو 'zh' أو 'ko'. ويُقبل أيضًا معرّف ISO من 3 أحرف مثل 'eng' أو 'spa' أو 'fra'.
font_nameاختياري
النوعstring
الافتراضيMontserrat
اسم الخط المختار من fonts.google.com؛ يُقبل أي Google Font، بما في ذلك 'Montserrat' و'Poppins' و'BBH Sans Hegarty'.
font_sizeاختياري
النوعinteger
الافتراضي100
20 – 150
حجم خط الترجمة؛ يستخدم تنسيق TikTok نصًا أكبر.
font_weightاختياري
النوعenum
الافتراضيbold
normalboldblack
سماكة النص؛ يستخدم تنسيق TikTok عادةً bold أو black.
font_colorاختياري
النوعenum
الافتراضيwhite
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
اللون المستخدم لكلمات الترجمة غير النشطة.
highlight_colorاختياري
النوعenum
الافتراضيpurple
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
لون التمييز بنمط الكاريوكي المطبق على الكلمة المنطوقة.
stroke_widthاختياري
النوعinteger
الافتراضي3
0 – 10
عرض مخطط النص أو حدّه، مقاسًا بالبكسل؛ تعطل القيمة 0 ذلك.
stroke_colorاختياري
النوعenum
الافتراضيblack
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
اللون المطبق على مخطط النص أو حدّه.
background_colorاختياري
النوعenum
الافتراضيnone
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagentanonetransparent
لون الخلفية خلف النص؛ يعطّل 'none' و'transparent' الخلفية معًا.
background_opacityاختياري
النوعnumber
الافتراضي0
0 – 1
شفافية الخلفية، حيث تعني 0.0 شفافية كاملة و1.0 عتامة كاملة.
positionاختياري
النوعenum
الافتراضيbottom
topcenterbottom
موضع الترجمة على المحور الرأسي.
y_offsetاختياري
النوعinteger
الافتراضي75
-200 – 200
الإزاحة الرأسية بالبكسل؛ تحرّك القيم الموجبة النص إلى الأسفل، بينما تحرّكه القيم السالبة إلى الأعلى.
words_per_subtitleاختياري
النوعinteger
الافتراضي3
1 – 12
الحد الأقصى لعدد كلمات الترجمة، ما يسمح بعرض كلمة واحدة عند 1، أو عبارة قصيرة عند 2–3، أو جملة كاملة عند 8–12 كلمة لكل مقطع.
enable_animationاختياري
النوعboolean
الافتراضيtrue
يمكّن تحريك الترجمة بتأثير دخول مرتد.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/auto-subtitle",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "transcription": "string",
    "subtitle_count": 1,
    "words": [
      {}
    ],
    "transcription_metadata": {}
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}فيديو يحتوي على ترجمات مُولّدة تلقائيًا.
transcription
stringالنص الكامل للنسخ.
subtitle_count
integerعدد مقاطع الترجمة المُولّدة.
words
array of object | nullبيانات توقيت الكلمات الفردية التي توفرها خدمة النسخ.
transcription_metadata
object | nullبيانات وصفية إضافية توفرها ElevenLabs للنسخ، بما في ذلك اللغة والمقاطع وتفاصيل أخرى.

مزيد من النماذج: من فيديو إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/workflow-utilities/auto-subtitle.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt