TokenLab

Â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

POST
/v1/audio/translations

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.

filefilebắt buộc

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.

modelstringbắt buộc

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.

promptstring

Đ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.

response_formatstringmặc định: 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.

temperaturenumber

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.

textstring

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:

languagestring

Nhãn ngôn ngữ được báo cáo trong phản hồi, khi được cung cấp.

durationnumber

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

segmentsarray

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ăngTranslationTranscription
Ngôn ngữ đầu raLuôn là tiếng AnhGiống như đầu vào
Trường hợp sử dụngChuyển đổi âm thanh 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