Teks

Buat Terjemahan

Menerjemahkan teks ke dalam bahasa target

POST
/v1/translations

Gambaran Umum

Gunakan /v1/translations untuk terjemahan teks-ke-teks.

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

Gunakan Models API untuk mendapatkan model terjemahan teks saat ini:

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

Kemudian kirimkan model yang dipilih secara eksplisit ke /v1/translations.

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

Body Permintaan

modelstringwajib

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

textstringwajib

Teks sumber yang akan diterjemahkan. Batas panjang input bergantung pada model; lihat max_input_tokens di GET /v1/models/{model}.

target_languagestringwajib

Kode bahasa target atau nama bahasa, bergantung pada dukungan model.

source_languagestring

Petunjuk bahasa sumber opsional.

mime_typestringbawaan: text/plain

Format teks sumber: text/plain atau text/html. Kirimkan hanya jika detail model mencantumkan mime_type.

userstring

Pengenal pengguna akhir (end-user) opsional untuk pemantauan penyalahgunaan dan pelacakan permintaan. Kirimkan hanya jika detail model mencantumkan user.

Respons

textstring

Teks yang diterjemahkan.

modelstring

Model yang menghasilkan terjemahan.

source_languagestring | null

Bahasa sumber yang terdeteksi atau diterima oleh model.

target_languagestring

Bahasa target yang digunakan untuk permintaan tersebut.

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

Error

StatusKodePenyebab
400invalid_requestmodel, text, atau target_language tidak ada atau kosong, atau mime_type bukan salah satu dari dua nilai yang valid. param menyebutkan nama field
400unsupported_endpointModel tidak dipublikasikan untuk endpoint ini

Tangani status lainnya seperti pada Penanganan error API.

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