Dokumentasi API

Integrate kuat terjemahan ke aplikasi Anda dengan API REST sederhana kami.

Mulai

TerjemahanAPI menyediakan antarmuka sederhana untuk menerjemahkan teks antara 180+ bahasa. Semua titik akhir API membalas respon JSON.

URL Dasar: https://api.translateapi.ai/api/v1/
Cepat Mulai

Membuat permintaan terjemahan pertama Anda:

curl -X POST https://api.translateapi.ai/api/v1/translate/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "Hello, world!",
    "target_language": "es"
  }'
import requests

response = requests.post(
    "https://api.translateapi.ai/api/v1/translate/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "text": "Hello, world!",
        "target_language": "es"
    }
)

result = response.json()
print(result["translated_text"])  # "Hola, mundo!"
const response = await fetch("https://api.translateapi.ai/api/v1/translate/", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        text: "Hello, world!",
        target_language: "es"
    })
});

const result = await response.json();
console.log(result.translated_text);  // "Hola, mundo!"
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Add(
            "Authorization", "Bearer YOUR_API_KEY"
        );

        var content = new StringContent(
            JsonConvert.SerializeObject(new {
                text = "Hello, world!",
                target_language = "es"
            }),
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync(
            "https://api.translateapi.ai/api/v1/translate/",
            content
        );

        var result = await response.Content.ReadAsStringAsync();
        var data = JsonConvert.DeserializeObject<dynamic>(result);
        Console.WriteLine(data.translated_text);  // "Hola, mundo!"
    }
}

Otentikasi

Otentikasi permintaan Anda memakai kunci API. Anda dapat membuat kunci API dari Anda dashboard.

Otentikasi Header (Disarankan)
Authorization: Bearer ta_your_api_key_here
Parameter Query
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
Jaga kunci API Anda tetap aman! Jangan mengekspos mereka dalam kode sisi klien atau repositori publik.

Terjemahkan Teks

Terjemahkan teks ke bahasa target tunggal.

POST https://api.translateapi.ai/api/v1/translate/
Badan Permintaan
Parameter Tipe Diperlukan Deskripsi
text string Ya Teks untuk diterjemahkan (maksimal 50.000 karakter)
target_language string Ya * Target language code (e.g., "es", "fr", "de")
source_language string Tidak Source language code. Default: "auto" (auto-detect)

* Gunakan target_language (string) untuk bahasa tunggal atau target_languages (array) untuk beberapa. lihat Terjemahan Multi-Target.

Tanggapan
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

Terjemahan Multi-Target

Terjemahkan teks ke berbagai bahasa dalam satu permintaan. Gunakan titik akhir yang sama dengan terjemahan tunggal.

Tip: Anda dapat menerjemahkan hingga 50 bahasa dalam satu permintaan.
POST https://api.translateapi.ai/api/v1/translate/
Badan Permintaan
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

Gunakan target_languages (array) bukan target_language (string) untuk beberapa target.

Tanggapan
{
    "source_language": "en",
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "character_count": 52,
    "translation_time": 2.31
}

Terjemahan Batch

Terjemahkan beberapa teks sekaligus dengan pemrosesan sinkronisasi. Kirim batch dan jajak pendapat untuk hasil.

Batas: maksimal 500 teks per batch, maksimal 750 butir (teks × target bahasa). Waktu kerja habis 30 menit setelah pemrosesan dimulai (waktu tunggu tak dihitung).
Proses waktu berbeda dengan bahasa: bahasa umum (Spanyol, Jerman, dll) menggunakan model cepat (~0.1s per teks), sementara bahasa yang kurang umum menggunakan model multibahasa kita (~1-3s per teks). Sebuah batch 100 teks biasanya lengkap dalam 10-30 detik untuk bahasa umum, atau 2-5 menit untuk yang kurang umum. Untuk hasil terbaik, kirim 1 target bahasa per permintaan batch dan tetap batch ukuran dibawah 50 teks.
POST https://api.translateapi.ai/api/v1/translate/batch/
Langkah 1: Masukkan Batch
curl -X POST https://api.translateapi.ai/api/v1/translate/batch/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["Hello", "Goodbye", "Thank you"],
    "target_language": "es",
    "source_language": "en"
}'
Tanggapan (HTTP 202 Diterima)
{
    "job_id": "67535b2b-c9e3-4f82-9499-e237edbc1dd8",
    "status": "pending",
    "total_texts": 3,
    "queue_position": 1,
    "source_language": "en",
    "target_languages": ["es"],
    "character_count": 22,
    "credits_remaining": -1,
    "poll_url": "https://api.translateapi.ai/api/v1/jobs/67535b2b-c9e3-4f82-9499-e237edbc1dd8/"
}
Langkah 2: Poll untuk Hasil
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
Contoh Polling (Python)
import time, requests

job_id = response.json()["job_id"]
total = response.json()["total_texts"]
headers = {"Authorization": "Bearer YOUR_API_KEY"}

print(f"Batch submitted: {total} texts (job {job_id})")

while True:
    result = requests.get(f"https://api.translateapi.ai/api/v1/jobs/{job_id}/", headers=headers).json()
    status = result["status"]
    processed = result.get("processed_texts", 0)
    progress = result.get("progress_percentage", 0)

    if status == "completed":
        print(f"Completed: {processed}/{total} texts in {result.get('processing_time', 0):.1f}s")
        translations = result["result_data"]["translations"]
        break
    elif status == "failed":
        print(f"Failed at {processed}/{total}: {result.get('error_message', 'unknown')}")
        raise Exception(result.get("error_message", "Translation failed"))
    elif status == "pending":
        queue_pos = result.get("queue_position", "?")
        print(f"Queued (position {queue_pos}) — waiting for GPU worker...")
    else:
        print(f"[{status}] {processed}/{total} ({progress:.0f}%)")

    time.sleep(3)
Respon (membuka antrian, menunggu GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
Tanggapan (saat memproses)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
Respon (selesai)
{
    "job_id": "67535b2b-...",
    "status": "completed",
    "processed_texts": 3,
    "total_texts": 3,
    "progress_percentage": 100.0,
    "processing_time": 10.65,
    "result_data": {
        "translations": ["Hola", "Adiós", "Gracias"],
        "source_language": "en",
        "target_language": "es",
        "character_count": 22,
        "processing_time": 10.65
    }
}
Pelacakan Progres Real-Time

Setiap respon poll termasuk real-time progress fields sehingga Anda dapat memantau persis apa yang terjadi dengan batch Anda:

Ruas Deskripsi
status Kondisi tugas saat ini: pending (queued, menunggu pekerja GPU), processing (secara aktif menerjemahkan), completed, failed
processed_texts Jumlah terjemahan individu yang selesai sejauh ini. Pemutakhiran secara real time ketika setiap teks diterjemahkan.
total_texts Jumlah terjemahan dalam batch ini (teks × target bahasa).
progress_percentage Persentase pelengkapan (0-100). Dihitung dari proses_teks / total_texts.
queue_position Posisi Anda di antrian ketika status "pending" (1 = selanjutnya). Null ketika memproses atau menyelesaikan. Gunakan ini untuk memperkirakan waktu tunggu dan tampilkan status antrian ke pengguna Anda.
processing_time Total waktu pemrosesan dalam detik (tersedia ketika selesai).
Tip: Ketika status adalah "pending"Para pekerja GPU sibuk dengan batch lainnya. queue_position untuk melihat berapa banyak pekerjaan di depan Anda (1 = Anda berikutnya). pekerjaan Anda akan dimulai secara otomatis tidak ada tindakan yang diperlukan, hanya terus melakukan pemungutan suara.
Praktek Terbaik bagi Beban Kerja Besar
  • Kirim 1 bahasa target per permintaan batch. Hal ini membuat setiap batch cepat dan membuat kemajuan mudah untuk dilacak.
  • Simpan batch pada 50-100 teks. batch lebih kecil lengkap lebih cepat dan memberikan Anda lebih sering update kemajuan.
  • Jalankan paling banyak 2 proses batch bersama. Proses GPU 2 batch dalam antrian pekerjaan tambahan paralel dan tidak akan mulai lebih cepat.
  • Pada waktu habis, kembali-poll pekerjaan yang sama_id bukan mengirimkan batch baru. Pekerjaan asli mungkin masih diproses di GPU.
  • Lebih sering polling tidak mempercepat pemrosesan.
Batch Multi-Bahasa

Terjemahkan beberapa teks ke berbagai bahasa sekaligus:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
Hasil_data selesai
{
    "translations": [
        {"es": "Hola", "fr": "Bonjour"},
        {"es": "Adiós", "fr": "Au revoir"}
    ],
    "source_language": "en",
    "target_languages": ["es", "fr"],
    "character_count": 24,
    "processing_time": 2.45
}
Parameter Permintaan
Parameter Tipe Diperlukan Deskripsi
texts array Ya Array string untuk menerjemahkan
target_language string Ya * Target kode bahasa untuk bahasa tunggal
target_languages array Ya * Array dari kode bahasa target untuk berbagai bahasa
source_language string Tidak Source language code. Default: "auto"

* Berikan baik target_language atau target_languagesBukan keduanya.

Async Prosesing: Permintaan Batch segera kembali dengan job_id. Poll GET /api/v1/jobs/{job_id}/ hingga status adalah "completed", lalu baca result_data untuk terjemahan. Gunakan progress_percentage untuk melacak kemajuan.

Terjemahan Dokumen

Terjemahkan seluruh dokumen saat melestarikan format. Mendukung beberapa format berkas.

POST https://api.translateapi.ai/api/v1/translate/document/
Permintaan (multipart/form-data)
Parameter Tipe Diperlukan Deskripsi
file file Ya Dokumen untuk diterjemahkan (max 10MB)
target_language string Ya Target language code (e.g., "es", "fr", "de")
source_language string Tidak Source language code. Default: "auto" (auto-detect)
Tipe Berkas Yang Didukung
  • .txt - Berkas teks biasa
  • .docx - Dokumen Word
  • .pdf - Dokumen PDF (termasuk pemindaian)
  • .json - Berkas JSON (menterjemahkan nilai string)
  • .xml - Berkas XML
  • .srt - Berkas subjudul
  • .po / .pot - Berkas terjemahan Gettext
  • .jpg / .jpeg - Gambar JPEG (OCR)
  • .png - Gambar PNG (OCR)
  • .tiff / .tif - Citra TIFF (OCR)
  • .bmp - Gambar BMP (OCR)
  • .webp - Citra WebP (OCR)
Dukungan OCR: Berkas gambar dan dipindai PDF diproses dengan pengenalan karakter optik (OCR) untuk mengekstrak teks sebelum terjemahan. Untuk hasil terbaik, gunakan gambar resolusi tinggi yang jelas.
Contoh (kurl)
# Translate a Word document
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.docx" \
  -F "target_language=es" \
  -F "source_language=en"

# Translate text from an image (OCR)
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@scanned_page.jpg" \
  -F "target_language=es" \
  -F "source_language=en"
Berkas gambar diproses dengan OCR untuk mengekstrak teks sebelum terjemahan. Keluaran terjemahan dikembalikan sebagai sebuah .txt berkas.
Tanggapan
{
    "id": 123,
    "original_filename": "document.docx",
    "file_type": "docx",
    "source_language": "en",
    "target_language": "es",
    "status": "completed",
    "character_count": 5420,
    "translated_file_url": "/media/translated/document_es.docx",
    "created_at": "2024-01-15T10:30:00Z",
    "completed_at": "2024-01-15T10:30:05Z"
}
Nilai Status
pending Berkas diunggah, menunggu diproses
processing Penerjemahan sedang berlangsung
completed Terjemahan selesai, download tersedia
failed Terjemahan gagal (check error_message)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

Periksa status dari sebuah terjemahan dokumen atau ambil kembali URL unduhan.

Tanggapan
{
    "id": 123,
    "original_filename": "document.docx",
    "status": "completed",
    "translated_file_url": "/media/translated/document_es.docx",
    "character_count": 5420
}

Deteksi Bahasa

Pendeteksian bahasa dibangun ke dalam setiap permintaan terjemahan. Atur source_language to "auto" (atau abaikan itu) dan bahasa yang terdeteksi dikembalikan sebagai tanggapan.

POST https://api.translateapi.ai/api/v1/translate/
Badan Permintaan
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
Tanggapan
{
    "translated_text": "Hello, how are you?",
    "source_language": "fr",
    "target_language": "en",
    "translations": {
        "en": "Hello, how are you?"
    },
    "character_count": 28,
    "translation_time": 0.52
}

The source_language field dalam respon menunjukkan bahasa terdeteksi ketika auto-detection digunakan.

Bahasa yang Didukung

Dapatkan daftar semua bahasa yang didukung.

GET https://api.translateapi.ai/api/v1/translate/languages/
Tanggapan
{
    "count": 186,
    "results": [
        {"iso": "en", "name": "English", "en_label": "English"},
        {"iso": "es", "name": "Español", "en_label": "Spanish"},
        {"iso": "fr", "name": "Français", "en_label": "French"},
        ...
    ]
}

Model Penerjemahan

Kami menggunakan model terjemahan open source yang canggih yang berjalan pada infrastruktur GPU kami sendiri. Semua model dilisensikan secara komersial (Apache 2.0).

Model Bahasa Terbaik Untuk
Helsinki-NLP/opus-mt 50+ pasangan bahasa Bahasa umum (EN, ES, FR, DE, IT, PT, RUS, ZH, JA, dsb.)
Google MADLAD-400 400+ bahasa Bahasa langka, cakupan komprehensif

API secara otomatis memilih model terbaik bagi pasangan bahasa Anda. Anda dapat menentukan secara opsional engine parameter:

Mesin Deskripsi
"auto" Tries HuggingFace pertama, jatuh kembali ke MADLAD-400
"huggingface" Force Huggingface/MarianMT (paling cepat, 50 bahasa+)
"madlad" Force MADLAD-400 (400+ bahasa)

Kesalahan Menangani

API menggunakan kode status HTTP standar untuk mengindikasikan sukses atau gagal.

Kode Deskripsi
200 Berhasil
400 Permintaan Salah - parameter tidak valid
401 Tak berwenang - Kunci API tak valid atau hilang
402 Pembayaran Diperlukan - Kuota karakter harian melebihi
429 Terlalu Banyak Permintaan - Batas Rasio terlampaui
503 Layanan mesin Terjemahan untuk sementara tidak tersedia
Format Respon Galat
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

Batas Laju

Batasnya bervariasi sesuai rencana. Harga untuk rincian lengkap:

Rencana Karakter/Bulan Harga
Bebas 250,000 $0 Daftar Bebas
Pemulai 2,500,000 $9/mo Berlangganan
Pro 10,000,000 $29/mo Berlangganan
Bisnis 40,000,000 $79/mo Berlangganan
Skala 125,000,000 $199/mo Berlangganan

Ketika Anda melampaui batas Anda, Anda akan menerima 429 Too Many Requests respon sampai bulan depan atau Anda upgrade.

Infrastruktur Awan Skala Otomatis

TerjemahkanAPI berjalan pada NVIDIA A100 GPU instansi dengan skala horizontal otomatis. Ketika permintaan meningkat, tambahan GPU instansi diluncurkan dalam hitungan menit untuk mempertahankan waktu respon cepat. Ini berarti API kita dapat menangani permintaan yang hampir tak terbatas tanpa degradasi ▪ dari satu permintaan satu per menit.

Laju halaman ini
Terima kasih atas ratingmu!
/5 berdasarkan peringkat