Văn bản
Tạo bản dịch
Dịch văn bản sang ngôn ngữ mục tiêu
Tổng quan
Sử dụng /v1/translations để dịch văn bản sang văn bản.
Endpoint này khác với Dịch âm thanh, vốn chấp nhận tệp âm thanh và luôn xuất ra văn bản tiếng Anh.
Sử dụng Models API để lấy các mô hình dịch văn bản hiện có:
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"Sau đó, gửi rõ ràng mô hình đã chọn tới /v1/translations.
recommended_for=translation chỉ áp dụng cho dịch văn bản (POST /v1/translations). Nó không áp dụng cho dịch âm thanh.
Phần thân yêu cầu (Request Body)
ID mô hình dịch được trả về bởi /v1/models?recommended_for=translation.
Văn bản nguồn cần dịch. Giới hạn độ dài đầu vào phụ thuộc vào mô hình; hãy đọc max_input_tokens trong GET /v1/models/{model}.
Mã ngôn ngữ hoặc tên ngôn ngữ mục tiêu, tùy thuộc vào khả năng hỗ trợ của mô hình.
Gợi ý ngôn ngữ nguồn tùy chọn.
text/plainĐịnh dạng văn bản nguồn: text/plain hoặc text/html. Chỉ gửi khi chi tiết mô hình liệt kê mime_type.
Định danh người dùng cuối tùy chọn để giám sát hành vi lạm dụng và theo dõi yêu cầu. Chỉ gửi khi chi tiết mô hình liệt kê user.
Phản hồi (Response)
Văn bản đã dịch.
Mô hình đã tạo bản dịch.
Ngôn ngữ nguồn được phát hiện hoặc được mô hình chấp nhận.
Ngôn ngữ mục tiêu được sử dụng cho yêu cầu.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/translations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-translation",
"text": "你好,欢迎使用 TokenLab。",
"target_language": "en"
}'Phản hồi
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Lỗi
| Trạng thái | Mã | Nguyên nhân |
|---|---|---|
400 | invalid_request | model, text, hoặc target_language bị thiếu hoặc trống, hoặc mime_type không phải là một trong hai giá trị hợp lệ. param chỉ định trường bị lỗi |
400 | unsupported_endpoint | Mô hình không được xuất bản cho endpoint này |
Xử lý các trạng thái khác như trong phần Xử lý lỗi API.
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
application/json
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json