TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Teks

Buat Terjemahan

Menerjemahkan teks ke bahasa target

POST
/v1/translations

Ikhtisar

Gunakan /v1/translations untuk terjemahan teks ke teks.

Endpoint ini berbeda dari Terjemahan Audio, yang menerima file audio dan selalu menghasilkan teks bahasa Inggris.

Untuk alur agent, temukan dulu model terjemahan yang direkomendasikan saat ini:

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

Lalu kirim model yang dipilih secara eksplisit ke /v1/translations.

recommended_for=translation hanya berlaku untuk terjemahan teks (POST /v1/translations). Tidak berlaku untuk terjemahan audio.

Body Request

modelstringwajib

ID model terjemahan yang dikembalikan dari /v1/models?recommended_for=translation.

textstringwajib

Teks sumber yang ingin diterjemahkan.

target_languagestringwajib

Kode bahasa target atau nama bahasa, tergantung dukungan model.

source_languagestring

Petunjuk bahasa sumber opsional.

mime_typestringbawaan: text/plain

Format teks sumber. Nilai yang didukung: text/plain, text/html.

userstring

Identifier end-user opsional untuk monitoring abuse dan pelacakan request.

Respons

textstring

Teks yang sudah diterjemahkan.

modelstring

Model yang menghasilkan terjemahan.

source_languagestring | null

Bahasa sumber yang dideteksi atau diterima model.

target_languagestring

Bahasa target yang digunakan untuk request.

Permintaan

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

Respons

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

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

  • "auto"
  • "verified"
  • "official"

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

application/json

application/json

Mengevaluasi Keputusan

Sebelumnya

Unggah File

Berikutnya