Âm thanh & thời gian thực
Tạo bản dịch
Dịch âm thanh thành văn bản tiếng Anh
Tổng quan
Dịch âm thanh thuộc bất kỳ ngôn ngữ nào được hỗ trợ sang văn bản tiếng Anh. Không giống như chép lời, endpoint này luôn xuất ra văn bản tiếng Anh bất kể ngôn ngữ đầu vào.
Endpoint này dịch âm thanh sang tiếng Anh. Không gửi language; tham số này không được hỗ trợ cho dịch âm thanh và có thể trả về unsupported_parameter. Đối với dịch văn bản, hãy sử dụng POST /v1/translations; recommended_for=translation đề cập đến API văn bản đó.
Phần thân yêu cầu (Request Body)
Kết quả dịch sẽ trả về khi quá trình xử lý hoàn tất. Đối với âm thanh dài hơn, hãy cho phép thời gian chờ timeout của HTTP client tối thiểu là 120s.
Tệp âm thanh 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.
Hiện không có model công khai nào tuyên bố hỗ trợ cho POST /v1/audio/translations; không có model ID mặc định hoặc có thể sao chép.
Đoạn 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 đó. Phải bằng tiếng Anh.
jsonĐịnh dạng đầu ra. Các giá trị được chấp nhận tùy thuộc vào model; hãy kiểm tra chi tiết của model đó. text trả về văn bản thô thay vì một đối tượng JSON.
Nhiệt độ lấy mẫu (sampling temperature) từ 0 đến 1, chỉ dành cho các model liệt kê tham số này.
Phản hồi
Các trường bên dưới mô tả phản hồi JSON của bản chép lời hoặc bản dịch. text, srt, và vtt trả về văn bản thô hoặc phụ đề thay vì một đối tượng JSON. Các trường bổ sung tùy thuộc vào model và định dạng đầu ra.
Văn bản đã dịch sang tiếng Anh.
Đối với định dạng verbose_json, phản hồi cũng bao gồm:
Nhãn ngôn ngữ được báo cáo trong phản hồi, khi được cung cấp.
Thời lượng của âm thanh đầu vào tính bằng giây.
Các phân đoạn của văn bản đã dịch kèm theo mốc 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 "model=your-model-id" \
-F "file=@german_audio.mp3"Phản hồi
{
"text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}Translation vs Transcription
| Tính năng | Translation | Transcription |
|---|---|---|
| Ngôn ngữ đầu ra | Luôn là tiếng Anh | Giống như đầu vào |
| Trường hợp sử dụng | Chuyển đổi âm thanh tiếng nước ngoài sang tiếng Anh | Giữ nguyên ngôn ngữ gốc |
| Tham số ngôn ngữ | Không áp dụng | Gợi ý tùy chọn |
Xác thực
BearerAuth 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
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