TokenLab

Văn bản

Tạo Bản Dịch

Dịch văn bản sang ngôn ngữ đích

POST
/v1/translations

Tổng Quan

Sử dụng /v1/translations cho dịch văn bản sang văn bản.

Endpoint này khác với Dịch Âm Thanh, dịch âm thanh nhận một tệp âm thanh và luôn xuất ra văn bản tiếng Anh.

Với các luồng agent, trước tiên hãy khám phá các model dịch được khuyến nghị hiện tại:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

Sau đó gửi rõ model đã chọn đến /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.

Thân Yêu Cầu

modelstringbắt buộc

ID model dịch được trả về từ /v1/models?recommended_for=translation.

textstringbắt buộc

Văn bản nguồn cần dịch.

target_languagestringbắt buộc

Mã ngôn ngữ đích hoặc tên ngôn ngữ, tùy theo hỗ trợ của model.

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. Giá trị hỗ trợ: text/plain, text/html.

userstring

Định danh người dùng cuối tùy chọn để giám sát lạm dụng và theo dõi request.

Phản Hồi

textstring

Văn bản đã được dịch.

modelstring

Model đã tạo bản dịch.

source_languagestring | null

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

target_languagestring

Ngôn ngữ đích được dùng cho request.

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

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