TokenLab

Văn bản

Tạo bản dịch

Dịch văn bản sang ngôn ngữ mục tiêu

POST
/v1/translations

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)

modelstringbắt buộc

ID mô hình dịch được trả về bởi /v1/models?recommended_for=translation.

textstringbắt buộc

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

target_languagestringbắt buộc

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.

source_languagestring

Gợi ý ngôn ngữ nguồn tùy chọn.

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

userstring

Đị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)

textstring

Văn bản đã dịch.

modelstring

Mô hình đã tạo bản dịch.

source_languagestring | null

Ngôn ngữ nguồn được phát hiện hoặc được mô hình chấp nhận.

target_languagestring

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

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

Lỗi

Trạng tháiMãNguyên nhân
400invalid_requestmodel, 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
400unsupported_endpointMô 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
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

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json