ข้ามไปยังเนื้อหา

Subtitles

ผสานการทำงาน

ID โมเดล 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"

ไฟล์เช่นเดียวกับตัวอย่าง: $0.20 200 เครดิต API ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API

ฝังคำบรรยายที่มีสไตล์ลงในวิดีโอจากการถอดเสียงอัตโนมัติหรือ SRT ของคุณเอง พร้อมตัวเลือกการแปล

VEED · วิดีโอ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น 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"

การปรับแต่งค่าที่ตั้งไว้ล่วงหน้าเพิ่มเติม โดยคงค่าเริ่มต้นไว้สำหรับฟิลด์ที่ไม่ได้ระบุ สามารถแทนที่ตำแหน่งแนวตั้งและความเข้มของเงา รวมถึงแบบอักษร น้ำหนัก และสีฐานสิบหกแยกกันสำหรับแต่ละระดับความสำคัญของคำ

POST /run/veed/subtitles?wait=20 ใบเสนอราคา → $0.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

เพิ่มคำบรรยายที่เรนเดอร์แล้วลงในวิดีโอ (`video_url`) โดยใช้ `preset` รูปแบบที่จำเป็น ซึ่งมีให้เลือก 30 รูปแบบ ระบบจะถอดเสียงอัตโนมัติ หรือข้ามขั้นตอนนี้หากคุณระบุ `srt_file_url` หรือ `srt_content` `language` กำหนดภาษาต้นฉบับเพื่อความแม่นยำ และ `translation_language` ใช้แปลคำบรรยาย รายการ `vocabulary` ที่มีคำได้สูงสุด 100 คำและการปรับแต่งใน `customization` ช่วยปรับปรุงผลลัพธ์

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
video_urlจำเป็น video
ประเภทurl · video
≤ 2,083 อักขระ
วิดีโอต้นฉบับสำหรับทำคำบรรยาย โดยอัปโหลดไฟล์หรือวาง 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
≤ 2,083 อักขระ
ส่งคำบรรยายแทนการถอดเสียง โดยอัปโหลดไฟล์ .srt หรือวาง URL
srt_contentไม่บังคับ
ประเภทstring | null
ข้อความคำบรรยายดิบในรูปแบบ SRT ซึ่งส่งแทน srt_file_url การระบุค่านี้จะข้ามการถอดเสียง
vocabularyไม่บังคับ
ประเภทobject[]
≤ 100 รายการ
คำศัพท์เสริมสำหรับการถอดเสียง มีผลเฉพาะเมื่อไม่ได้ระบุทั้ง 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
การปรับแต่งค่าที่ตั้งไว้ล่วงหน้าเพิ่มเติม โดยคงค่าเริ่มต้นไว้สำหรับฟิลด์ที่ไม่ได้ระบุ สามารถแทนที่ตำแหน่งแนวตั้งและความเข้มของเงา รวมถึงแบบอักษร น้ำหนัก และสีฐานสิบหกแยกกันสำหรับแต่ละระดับความสำคัญของคำ
customization.positionไม่บังคับ
ประเภทenum
topcenterbottom
ตำแหน่งหน้าจอตามแกนแนวตั้งสำหรับคำบรรยายแบบคงที่
customization.shadowไม่บังคับ
ประเภทenum
noneminmidmax
การเพิ่มความอ่านง่ายของคำบรรยายบนพื้นหลังสว่างหรือมีองค์ประกอบรบกวนทางสายตา
customization.text_customizationsไม่บังคับ
ประเภทobject
การตั้งค่าลักษณะข้อความตามระดับ ครอบคลุมคำพื้นฐานและคำที่เน้น
customization.text_customizations.baselineไม่บังคับ
ประเภทobject
ลักษณะข้อความเริ่มต้นสำหรับคำทั้งหมดในบทถอดเสียง ซึ่งมองเห็นได้ก่อนที่คำใด ๆ จะได้รับการเน้นเป็นรายคำ
customization.text_customizations.highlightedไม่บังคับ
ประเภทobject
การจัดรูปแบบสำหรับระดับคำขั้นกลาง ซึ่งค่าที่ตั้งไว้ล่วงหน้ามักเน้นด้วยขนาดหรือน้ำหนักที่มากขึ้น คำจะเข้าสู่ระดับนี้โดยอัตโนมัติเมื่อถูกระบุว่าน่าสนใจ รวมถึงคำนามสำคัญ คำกริยาแสดงการกระทำ และคำคุณศัพท์ที่โดดเด่น
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 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-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง
ฟิลด์ของเอาต์พุต
video
object {url, content_type, file_name, file_size}วิดีโอที่เรนเดอร์พร้อมคำบรรยายที่จัดรูปแบบแล้ว

โมเดลเพิ่มเติม: วิดีโอเป็นวิดีโอ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/veed/subtitles.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt