رفتن به محتوا

Subtitles

یکپارچه‌سازی

شناسه مدل veed/subtitles
# 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/veed/subtitles?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",
    "preset": "glass"
  }'

# 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"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۲۰⁩ ۲۰۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
VEED · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی video_url
یک فایل بیندازید، یا

ویدیوی منبع برای زیرنویس؛ فایل را بارگذاری کنید یا URL آن را وارد کنید.

•الزامی

انتخاب سبک برای تایپوگرافی، رنگ، چیدمان و پویانمایی، با رندر غنی‌تر متناسب با زمینه ورودی. پیش‌تنظیم‌های پایه از ضریب 1 استفاده می‌کنند و با سبک ثابت و سبک‌وزن نتایج قابل‌پیش‌بینی می‌دهند: vegas, rizz, mint, flex, sprout, karl, hustle, kitty, slay, ali, diego, vinta, lowkey, capri, casper, shadeplay, boo, corpo, beans, plain, simple.

زبان مقصد ترجمه زیرنویس‌ها؛ برای مطمئن‌ترین ترجمه با `srt_content` یا `srt_file_url`، زبان منبع آن‌ها را نیز در `language` ارائه کنید. بدون مقصد، زیرنویس‌ها به زبان گفتاری اصلی باقی می‌مانند.

پیشرفته srt_file_url · language · srt_content · vocabulary · customization
یک فایل بیندازید، یا

به‌جای اجرای رونویسی، زیرنویس را با بارگذاری فایل .srt یا واردکردن URL آن ارائه کنید.

زبان صوت منبع، نه زیرنویس‌های تولیدشده. تطبیق آن با صوت دقت رونویسی را افزایش می‌دهد.

متن خام زیرنویس در قالب SRT که به‌جای srt_file_url ارائه می‌شود. ارائه آن رونویسی را دور می‌زند.

واژگان اختیاری رونویسی که فقط وقتی srt_content و srt_file_url هیچ‌کدام ارائه نشده‌اند فعال است. نام برندها و اصطلاحات تخصصی‌ای را وارد کنید که ارائه‌دهندگان رونویسی اغلب اشتباه می‌نویسند، برای نمونه "VEED" → "vid".

شخصی‌سازی اختیاری پیش‌تنظیم که هرجا فیلدی حذف شده باشد مقادیر پیش‌فرض را حفظ می‌کند. بازنویسی‌ها می‌توانند جایگاه عمودی و شدت سایه، و نیز قلم، وزن و رنگ hex را برای هر سطح اهمیت واژه جداگانه تنظیم کنند.

POST /run/veed/subtitles?wait=20 قیمت → ⁨‎$۰٫۲۰⁩
# 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/veed/subtitles?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",
    "preset": "glass"
  }'

# 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

درباره Subtitles

با استفاده از پیش‌تنظیم سبک اجباری `preset`، زیرنویس رندرشده به ویدیو (`video_url`) اضافه می‌کند؛ 30 پیش‌تنظیم در دسترس است. به‌طور خودکار رونویسی می‌کند، یا اگر `srt_file_url` یا `srt_content` بدهید از آن صرف‌نظر می‌کند. `language` زبان منبع را برای دقت تعیین می‌کند و `translation_language` زیرنویس را ترجمه می‌کند. فهرست `vocabulary` با حداکثر 100 اصطلاح و بازنویسی‌های `customization` نتیجه را بهبود می‌دهند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
≤ ۲٬۰۸۳ نویسه
ویدیوی منبع برای زیرنویس؛ فایل را بارگذاری کنید یا URL آن را وارد کنید.
presetالزامی
نوعenum
glasswhisperglide2fusionglideterminalhandwrittenbackdropbackdrop2simpleplainbeanscorpobooshadeplaycasper
+14 مورد دیگرcaprilowkeyvintadiegoalislaykittyhustlekarlsproutflexmintrizzvegas
انتخاب سبک برای تایپوگرافی، رنگ، چیدمان و پویانمایی، با رندر غنی‌تر متناسب با زمینه ورودی. پیش‌تنظیم‌های پایه از ضریب 1 استفاده می‌کنند و با سبک ثابت و سبک‌وزن نتایج قابل‌پیش‌بینی می‌دهند: vegas, rizz, mint, flex, sprout, karl, hustle, kitty, slay, ali, diego, vinta, lowkey, capri, casper, shadeplay, boo, corpo, beans, plain, simple.
languageاختیاری
نوعenum
af-ZAam-ETar-AEar-BHar-DZar-EGar-ILar-IQar-JOar-KWar-LBar-MAar-OMar-PSar-QAar-SA
+148 مورد دیگرar-TNast-ESaz-AZbabasbe-BYbg-BGbrbs-BAca-ESceb-PHckb-IQcs-CZcy-GBda-DKde-DEdyuel-GRen-AUen-GBen-INen-NZen-USeoes-ARes-BOes-CLes-COes-CRes-DOes-ECes-ESes-GTes-HNes-MXes-NIes-PAes-PEes-PRes-PYes-SVes-USes-UYes-VEet-EEeu-ESfa-IRfffi-FIfil-PHfofr-CAfr-FRfygagdgl-ESha-NGhawhe-ILhr-HRhsbhthu-HUhy-AMid-IDigis-ISit-ITja-JPja-Latn-JPjv-IDka-GEkabkam-KEkea-CVkk-KZko-KRkuky-KGlalb-LUlglijln-CDlo-LAlt-LTluo-KElv-LVmgmi-NZmk-MKmn-MNms-MYmt-MTnb-NOnl-NLnso-ZAny-MWoc-FRpl-PLps-AFpt-BRpt-PTro-ROrohru-RUrw-RWsahsk-SKsl-SIsmsn-ZWso-SOsq-ALsr-Latn-RSsr-RSsrdsssu-IDsv-SEsw-KEsw-TZtg-TJth-THtktntoktontr-TRts-ZAttuk-UAumb-AOur-INur-PKuz-UZvi-VNvrowo-SNxh-ZAyiyo-NGyue-Hant-HKzhzh-HKzh-TWzu-ZA
زبان صوت منبع، نه زیرنویس‌های تولیدشده. تطبیق آن با صوت دقت رونویسی را افزایش می‌دهد.
translation_languageاختیاری
نوعenum
abaceachaf-ZAakalzam-ETar-AEar-BHar-DZar-EGar-ILar-IQar-JOar-KWar-LB
+198 مورد دیگرar-MAar-OMar-PSar-QAar-SAar-TNawaayaz-AZbanbbcbe-BYbembewbg-BGbhobikbmbs-BAbtsbtxbuaca-ESceb-PHcggchmckb-IQcnhcocrhcrscs-CZcvcy-GBda-DKde-DEdindoidovdvdzeeel-GRen-AUen-GBen-INen-NZen-USeoes-ARes-BOes-CLes-COes-CRes-DOes-ECes-ESes-GTes-HNes-MXes-NIes-PAes-PEes-PRes-PYes-SVes-USes-UYes-VEet-EEeu-ESfa-IRfffi-FIfil-PHfjfr-CAfr-FRfygagaagdgl-ESgngomha-NGhawhe-ILhilhmnhr-HRhrxhthu-HUhy-AMid-IDigilois-ISit-ITja-JPja-Latn-JPjv-IDka-GEkk-KZko-KRkriktukuky-KGlalb-LUlglilijlmoln-CDlo-LAlt-LTltgluo-KEluslv-LVmaimakmgmi-NZminmk-MKmn-MNmni-Mteims-Arabms-MYmt-MTnb-NOnewnl-NLnrnso-ZAnusny-MWoc-FRompagpampappl-PLps-AFpt-BRpt-PTqurnro-ROromru-RUrw-RWscnsgshnsk-SKsl-SIsmsn-ZWso-SOsq-ALsr-Latn-RSsr-RSssstsu-IDsv-SEsw-KEsw-TZszltettg-TJth-THtitktntr-TRts-ZAttuguk-UAur-INur-PKuz-UZvi-VNxh-ZAyiyo-NGyuayue-Hant-HKzhzh-HKzh-TWzu-ZA
زبان مقصد ترجمه زیرنویس‌ها؛ برای مطمئن‌ترین ترجمه با `srt_content` یا `srt_file_url`، زبان منبع آن‌ها را نیز در `language` ارائه کنید. بدون مقصد، زیرنویس‌ها به زبان گفتاری اصلی باقی می‌مانند.
srt_file_urlاختیاری
نوعurl · file
≤ ۲٬۰۸۳ نویسه
به‌جای اجرای رونویسی، زیرنویس را با بارگذاری فایل .srt یا واردکردن URL آن ارائه کنید.
srt_contentاختیاری
نوعstring | null
متن خام زیرنویس در قالب SRT که به‌جای srt_file_url ارائه می‌شود. ارائه آن رونویسی را دور می‌زند.
vocabularyاختیاری
نوعobject[]
≤ ۱۰۰ مورد
واژگان اختیاری رونویسی که فقط وقتی srt_content و srt_file_url هیچ‌کدام ارائه نشده‌اند فعال است. نام برندها و اصطلاحات تخصصی‌ای را وارد کنید که ارائه‌دهندگان رونویسی اغلب اشتباه می‌نویسند، برای نمونه "VEED" → "vid".
vocabulary[].wordالزامی
نوعstring
1 – 100 characters
املای درست اصطلاح را ارائه کنید؛ ترجیحاً نام برند، محصول یا اصطلاح تخصصی حوزه شما.
vocabulary[].replacesالزامی
نوعstring[]
1 – 20 items
هر غلط املایی را یک‌بار فهرست کنید تا با `word` جایگزین شود. تطبیق به واژه کامل نیاز دارد اما بزرگی حروف را نادیده می‌گیرد: `['vid']` با `vid`، `Vid` و `VID` تطبیق می‌کند و برای هر حالت به ورودی جداگانه نیاز ندارد.
customizationاختیاری
نوعobject
شخصی‌سازی اختیاری پیش‌تنظیم که هرجا فیلدی حذف شده باشد مقادیر پیش‌فرض را حفظ می‌کند. بازنویسی‌ها می‌توانند جایگاه عمودی و شدت سایه، و نیز قلم، وزن و رنگ hex را برای هر سطح اهمیت واژه جداگانه تنظیم کنند.
customization.positionاختیاری
نوعenum
topcenterbottom
موقعیت عمودی زیرنویس‌های ثابت روی صفحه.
customization.shadowاختیاری
نوعenum
noneminmidmax
بهبود خوانایی زیرنویس‌ها روی پس‌زمینه‌های روشن یا بصری شلوغ.
customization.text_customizationsاختیاری
نوعobject
تنظیمات ظاهر متن بر اساس سطح، شامل واژه‌های پایه و برجسته‌شده.
customization.text_customizations.baselineاختیاری
نوعobject
ظاهر پیش‌فرض متن برای همه واژه‌های متن رونویسی، پیش از دریافت تأکید اختصاصی هر واژه.
customization.text_customizations.highlightedاختیاری
نوعobject
سبک‌دهی سطح واژه‌های رتبه میانی که پیش‌تنظیم‌ها معمولاً با اندازه یا وزن بیشتر برجسته می‌کنند. واژه‌ها هنگام مهم‌تشخیص‌داده‌شدن، از جمله اسم‌های کلیدی، فعل‌های کنشی و صفت‌های برجسته، خودکار وارد این سطح می‌شوند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "veed/subtitles",
  "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": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "preset": "glass"
  },
  "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
    }
  },
  "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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}ویدیوی رندرشده شامل زیرنویس‌های سبک‌دهی‌شده.

مدل‌های بیشتر: ویدیو به ویدیو

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/veed/subtitles.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt