TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Âm thanh & thời gian thực

Tạo Bản dịch

Dịch audio thành văn bản tiếng Anh

POST
/v1/audio/translations

Tổng quan

Dịch audio ở bất kỳ ngôn ngữ được hỗ trợ nào thành văn bản tiếng Anh. Không giống như transcription, endpoint này luôn trả về văn bản tiếng Anh bất kể ngôn ngữ đầu vào là gì.

Endpoint này dịch âm thanh sang tiếng Anh. Không gửi language; dịch âm thanh không hỗ trợ tham số này và có thể trả về unsupported_parameter. Để dịch văn bản, dùng POST /v1/translations; recommended_for=translation đề cập đến API văn bản đó.

Nội dung yêu cầu

Phản hồi được trả về khi dịch xong. Với âm thanh dài, đặt thời gian chờ HTTP ít nhất 120s.

filefilebắt buộc

Tệp audio cần dịch. Các định dạng được hỗ trợ: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Kích thước tệp tối đa là 25 MB.

modelstringmặc định: whisper-1

ID mô hình dịch âm thanh, chẳng hạn whisper-1. Xác nhận hỗ trợ POST /v1/audio/translations trong chi tiết mô hình hiện tại.

promptstring

Văn bản tùy chọn để định hướng phong cách của model hoặc tiếp tục một đoạn trước đó. Nên là tiếng Anh.

response_formatstringmặc định: json

Định dạng đầu ra. Whisper hỗ trợ json, text, srt, verbose_json và vtt; mô hình khác có thể hỗ trợ tập định dạng khác. Kiểm tra chi tiết mô hình.

temperaturenumber

Nhiệt độ lấy mẫu từ 0 đến 1, chỉ dành cho mô hình hỗ trợ tham số này.

Phản hồi

Các trường dưới đây mô tả phản hồi JSON cho chép lời hoặc dịch. text, srt và vtt trả về văn bản hoặc phụ đề thô thay vì đối tượng JSON. Trường bổ sung phụ thuộc vào mô hình và định dạng đầu ra.

textstring

Văn bản đã dịch bằng tiếng Anh.

Đối với định dạng verbose_json, phản hồi cũng bao gồm:

languagestring

Nhãn ngôn ngữ trong phản hồi, nếu được cung cấp.

durationnumber

Thời lượng của audio đầu vào tính bằng giây.

segmentsarray

Các đoạn của văn bản đã dịch kèm dấu thời gian.

Yêu cầu

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@german_audio.mp3" \
  -F "model=whisper-1"

Phản hồi

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

Dịch thuật so với Chuyển lời nói thành văn bản

Tính năngDịch thuậtTranscription
Ngôn ngữ đầu raLuôn là tiếng AnhGiống với đầu vào
Trường hợp sử dụngChuyển audio tiếng nước ngoài sang tiếng AnhGiữ nguyên ngôn ngữ gốc
Tham số ngôn ngữKhông áp dụngGợi ý tùy chọn

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"

Nội dung yêu cầu

multipart/form-data

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

Tạo bản chép lời

Trước

Realtime WebSocket

Tiếp