Teks
Buat Terjemahan
Menerjemahkan teks ke dalam bahasa target
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
ID model terjemahan yang dikembalikan oleh /v1/models?recommended_for=translation.
Teks sumber yang akan diterjemahkan. Batas panjang input bergantung pada model; lihat max_input_tokens di GET /v1/models/{model}.
Kode bahasa target atau nama bahasa, bergantung pada dukungan model.
Petunjuk bahasa sumber opsional.
text/plainFormat teks sumber: text/plain atau text/html. Kirimkan hanya jika detail model mencantumkan mime_type.
Pengenal pengguna akhir (end-user) opsional untuk pemantauan penyalahgunaan dan pelacakan permintaan. Kirimkan hanya jika detail model mencantumkan user.
Respons
Teks yang diterjemahkan.
Model yang menghasilkan terjemahan.
Bahasa sumber yang terdeteksi atau diterima oleh model.
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
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Error
| Status | Kode | Penyebab |
|---|---|---|
400 | invalid_request | model, text, atau target_language tidak ada atau kosong, atau mime_type bukan salah satu dari dua nilai yang valid. param menyebutkan nama field |
400 | unsupported_endpoint | Model tidak dipublikasikan untuk endpoint ini |
Tangani status lainnya seperti pada Penanganan error API.
Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Header
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