Bỏ qua đến nội dung

Workflow Utilities Auto Subtitle

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,005 $ 5 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Utility · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc video_url
Thả tệp hoặc

URL video để tự động thêm phụ đề.

Nâng cao 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 mặc định bold

Độ đậm văn bản; kiểu TikTok thường sử dụng bold hoặc black.

position mặc định bottom

Vị trí của phụ đề theo trục dọc.

mặc định en

Mã định danh ngôn ngữ phiên âm, chẳng hạn 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh' hoặc 'ko'. Cũng chấp nhận mã ISO 3 chữ cái như 'eng', 'spa' hoặc 'fra'.

mặc định Montserrat

Tên phông chữ được chọn từ fonts.google.com; chấp nhận mọi Google Font, bao gồm 'Montserrat', 'Poppins' và 'BBH Sans Hegarty'.

mặc định white

Màu dùng cho các từ phụ đề không hoạt động.

mặc định purple

Màu tô sáng kiểu karaoke áp dụng cho từ đang được nói.

mặc định black

Màu áp dụng cho đường viền hoặc nét chữ.

mặc định none

Màu nền phía sau văn bản; cả 'none' và 'transparent' đều tắt nền.

mặc định 100

Cỡ phông chữ phụ đề; kiểu TikTok sử dụng văn bản lớn hơn.

mặc định 3

Độ rộng đường viền hoặc nét chữ, tính bằng pixel; 0 tắt đường viền.

mặc định 0

Độ mờ của nền, trong đó 0.0 là hoàn toàn trong suốt và 1.0 là hoàn toàn đục.

mặc định 75

Độ dịch theo chiều dọc tính bằng pixel; giá trị dương dịch xuống, còn giá trị âm dịch lên.

mặc định 3

Giới hạn số từ phụ đề, cho phép hiển thị một từ với 1, cụm ngắn với 2–3 hoặc câu đầy đủ với 8–12 từ mỗi đoạn.

POST /run/workflow-utilities/auto-subtitle?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Workflow Utilities Auto Subtitle

Chuyển lời nói trong video thành văn bản và ghi phụ đề, tô sáng từ đang được phát âm. Tùy chọn kiểu gồm mọi tên Google Font, cỡ 20-150, độ đậm, màu văn bản và màu tô sáng, viền, màu nền và độ mờ, cùng vị trí trên, giữa hoặc dưới với độ lệch dọc. `words_per_subtitle` nằm trong khoảng 1 đến 12 và có thể bật hoặc tắt hoạt ảnh nảy. Ngoài ra còn trả về bản chép lời và thời điểm của từng từ.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
video_urlbắt buộc video
Kiểuurl · video
URL video để tự động thêm phụ đề.
languagetùy chọn
Kiểustring
Mặc địnhen
Mã định danh ngôn ngữ phiên âm, chẳng hạn 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh' hoặc 'ko'. Cũng chấp nhận mã ISO 3 chữ cái như 'eng', 'spa' hoặc 'fra'.
font_nametùy chọn
Kiểustring
Mặc địnhMontserrat
Tên phông chữ được chọn từ fonts.google.com; chấp nhận mọi Google Font, bao gồm 'Montserrat', 'Poppins' và 'BBH Sans Hegarty'.
font_sizetùy chọn
Kiểuinteger
Mặc định100
20 – 150
Cỡ phông chữ phụ đề; kiểu TikTok sử dụng văn bản lớn hơn.
font_weighttùy chọn
Kiểuenum
Mặc địnhbold
normalboldblack
Độ đậm văn bản; kiểu TikTok thường sử dụng bold hoặc black.
font_colortùy chọn
Kiểuenum
Mặc địnhwhite
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Màu dùng cho các từ phụ đề không hoạt động.
highlight_colortùy chọn
Kiểuenum
Mặc địnhpurple
whiteblackredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Màu tô sáng kiểu karaoke áp dụng cho từ đang được nói.
stroke_widthtùy chọn
Kiểuinteger
Mặc định3
0 – 10
Độ rộng đường viền hoặc nét chữ, tính bằng pixel; 0 tắt đường viền.
stroke_colortùy chọn
Kiểuenum
Mặc địnhblack
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagenta
Màu áp dụng cho đường viền hoặc nét chữ.
background_colortùy chọn
Kiểuenum
Mặc địnhnone
blackwhiteredgreenblueyelloworangepurplepinkbrowngraycyanmagentanonetransparent
Màu nền phía sau văn bản; cả 'none' và 'transparent' đều tắt nền.
background_opacitytùy chọn
Kiểunumber
Mặc định0
0 – 1
Độ mờ của nền, trong đó 0.0 là hoàn toàn trong suốt và 1.0 là hoàn toàn đục.
positiontùy chọn
Kiểuenum
Mặc địnhbottom
topcenterbottom
Vị trí của phụ đề theo trục dọc.
y_offsettùy chọn
Kiểuinteger
Mặc định75
-200 – 200
Độ dịch theo chiều dọc tính bằng pixel; giá trị dương dịch xuống, còn giá trị âm dịch lên.
words_per_subtitletùy chọn
Kiểuinteger
Mặc định3
1 – 12
Giới hạn số từ phụ đề, cho phép hiển thị một từ với 1, cụm ngắn với 2–3 hoặc câu đầy đủ với 8–12 từ mỗi đoạn.
enable_animationtùy chọn
Kiểuboolean
Mặc địnhtrue
Bật hiệu ứng động cho phụ đề với hiệu ứng xuất hiện nảy.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video chứa phụ đề được tạo tự động.
transcription
stringToàn bộ văn bản của bản phiên âm.
subtitle_count
integerSố lượng đoạn phụ đề được tạo.
words
array of object | nullDữ liệu thời gian cho từng từ do dịch vụ phiên âm cung cấp.
transcription_metadata
object | nullSiêu dữ liệu bổ sung do ElevenLabs cung cấp cho bản phiên âm, bao gồm ngôn ngữ, các đoạn và thông tin chi tiết khác.

Thêm mô hình: Video sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/workflow-utilities/auto-subtitle.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt