Bản dịch

transcript1 chuyển tệp phương tiện thành văn bản trước, rồi dịch văn bản transcript sang một ngôn ngữ bạn chọn. Bản dịch được căn theo từng đoạn và giữ nguyên mốc thời gian cùng người nói gốc. Đây chỉ là dịch văn bản: không lồng tiếng và không có âm thanh đã dịch.

Dịch miễn phí. Dịch dùng 0 phút và hiện trong lịch sử sử dụng của bạn như một mục miễn phí "Translation". Phút chuyển thành văn bản vẫn tính như thường, và một bản dịch thất bại không bao giờ làm transcript thất bại hay hoàn lại phút.

Dịch ngay khi chuyển thành văn bản

Thêm translate_to vào yêu cầu tạo bản chuyển văn bản. Đó là mã ISO 639-1 gồm hai chữ cái thường, ví dụ es hoặc en. Tham số hoạt động với liên kết video trong body JSON của POST /v1/transcriptions, với việc đặt chỗ tải lên theo phần và với tải lên multipart một bước.

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"}'

Với tải tệp lên, hãy gửi translate_to dưới dạng trường biểu mẫu:

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

Công cụ MCP transcribe cũng nhận translate_to. Mỗi yêu cầu một ngôn ngữ đích.

Dịch transcript đã có sẵn

Yêu cầu dịch cho một bản chuyển văn bản đã hoàn tất:

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 trả về 202:

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

Lời gọi này có tính idempotent. Bản dịch ở trạng thái processing hoặc completed được trả về nguyên trạng, còn bản dịch failed sẽ được thử lại. Công cụ MCP translate_transcription nhận id và language.

Đọc bản dịch

GET /v1/transcriptions/:id và các bản tải xuống dạng văn bản, SRT, VTT nhận tham số translation:

Phản hồi có đối tượng translation, hoặc null nếu không yêu cầu dịch:

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

status là processing, completed hoặc failed. Bản dịch thất bại còn có thông báo error. wait cũng chờ bản dịch đã yêu cầu; nếu hết thời gian chờ, trạng thái là processing. Công cụ MCP get_transcription có tham số translation với cùng các giá trị.

Webhook

Hai sự kiện báo kết quả bản dịch, ngoài transcription.completed và transcription.failed vốn không đổi:

data là đối tượng bản chuyển văn bản cộng thêm translation: { language, status, error }. Xem Webhooks để biết chữ ký và quy tắc gửi.