Dokumentasi

Memulai dengan l10n.dev

l10n.dev adalah platform lokalisasi bertenaga AI yang dibuat untuk pengembang dan tim lokalisasi. Platform ini menerjemahkan file i18n Anda sambil mempertahankan kunci, struktur, placeholder, dan bentuk jamak — dari agen AI, terminal, alur kerja CI, atau ruang kerja web Anda. Halaman ini memandu Anda melalui terjemahan pertama dan menunjukkan apa yang dapat dilakukan platform ini setelah Anda siap.

Langkah 1: Buat Akun

Satu akun per orang, mohon. Kami meminta Anda untuk tidak membuat akun duplikat — sistem otomatis mendeteksi dan memblokirnya agar akun gratis tetap adil dan tersedia untuk semua orang.

Buat API key Anda

Segala sesuatu di luar ruang kerja web — agen AI, CLI, GitHub Action, plugin, dan API — melakukan autentikasi dengan API key. Buat satu di API Keys halaman dan simpan di tempat yang aman: Anda akan menempelkannya ke konfigurasi agen, konfigurasi CLI, atau rahasia CI Anda. Anda dapat mencabut dan menerbitkan ulang key kapan saja.

Langkah 2: Pilih Cara Anda Ingin Melakukan Lokalisasi

Ada tiga cara untuk menggunakan l10n.dev. Semuanya berbagi mesin terjemahan, saldo karakter, glosarium, dan instruksi linguistik yang sama — jadi pilih yang sesuai dengan alur kerja Anda saat ini, dan gabungkan nanti.

Agen Lokalisasi AI (MCP)

Menghubungkan agen AI Anda ke server MCP kami mengubahnya menjadi alat lokalisasi profesional. Alih-alih menerjemahkan string sendiri — yang menghabiskan konteks dan tidak konsisten antar proses — agen memanggil l10n.dev sebagai mesin terjemahan khusus dan mendapatkan file yang sudah selesai. Ini seperti memiliki pakar lokalisasi di tim Anda.

  • Efisien token: konten yang diterjemahkan tidak pernah melewati jendela konteks agen Anda, sehingga asisten pengodean Anda tetap bekerja pada kode.
  • Jaminan format: kunci, urutan, placeholder, dan bentuk jamak kembali dalam keadaan utuh — tidak ada JSON rusak yang perlu diperbaiki setelahnya.
  • Memori persisten: glosarium dan instruksi linguistik disimpan di pihak kami, sehingga kualitas tidak bergantung pada apa yang diingat oleh agen.

Pengaturan hanya memerlukan satu perintah — berikut ini untuk Claude Code (Cursor, Windsurf, Copilot, Claude Desktop, dan Codex tercakup dalam panduan):

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Kemudian cukup minta agen Anda: "Terjemahkan src/i18n/en ke dalam bahasa Jerman dan Jepang." Agen akan mendeteksi struktur proyek Anda, menerjemahkan, dan menulis file untuk Anda.

Baca panduan Agen Lokalisasi AI

CLI & GitHub Actions

Paket npm ai-l10n membawa lokalisasi ke terminal dan alur kerja CI/CD Anda. Terjemahkan file secara manual saat mengembangkan, lalu pindahkan perintah yang sama persis ke dalam alur kerja sehingga string baru dilokalisasi sebelum mencapai peninjau.

  • Deteksi struktur proyek: arahkan ke file sumber Anda dan alat ini akan menemukan bahasa target Anda yang ada secara otomatis.
  • Inkremental secara default: dengan translateOnlyNewStrings, hanya string yang ditambahkan atau diubah yang dikirim dan ditagihkan.
  • Siap untuk alur kerja: berfungsi sama secara lokal, di GitHub Actions, GitLab CI, atau Jenkins.

Instal paket, simpan API key Anda, dan terjemahkan file pertama Anda:

npm install ai-l10n

npx ai-l10n config --api-key YOUR_API_KEY

# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update

# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update

Untuk menerjemahkan pada setiap push, tambahkan GitHub Action kami ke alur kerja Anda:

name: Auto-translate i18n files

on:
  push:
    branches: [main]
    paths: ['locales/en/**']

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

Baca panduan Otomatisasi Lokalisasi

Ruang Kerja Web

Ruang kerja adalah cara tercepat untuk melihat apa yang dihasilkan oleh layanan ini — tanpa API key, tanpa instalasi. Di sinilah Anda mengelola file, glosarium, instruksi, dan saldo Anda.

  1. Unggah file i18n Anda — JSON, YAML, PO, XLIFF, ARB, Markdown, atau teks biasa.
  2. Pilih bahasa sumber dan satu atau beberapa bahasa target.
  3. Secara opsional lampirkan glosarium dan instruksi linguistik, serta aktifkan penerjemahan hanya untuk string baru.
  4. Tekan Terjemahkan, pantau progresnya, lalu unduh hasilnya atau salin langsung ke repositori Anda.

Buka ruang kerja

Langkah 3: Sesuaikan Kualitas Terjemahan

Secara bawaan, AI sudah melihat kunci dan struktur file di sekitarnya sebagai konteks. Dua fitur ini memungkinkan Anda mengunci kosakata dan suara produk Anda, dan fitur ini berlaku untuk setiap jalur di atas — agen, CLI, ruang kerja, dan API.

Glosarium Bertenaga AI

Glosarium menentukan bagaimana nama produk, nama fitur, dan istilah domain Anda harus diterjemahkan. Aktifkan pembuatan glosarium dan l10n.dev akan membangunnya secara otomatis dari konten sumber dan konten terjemahan Anda, menyimpannya sebagai glosarium aktif untuk pasangan bahasa tersebut — sehingga setiap terjemahan di masa mendatang tetap sesuai merek dan konsisten. Anda juga dapat mengimpor glosarium Anda sendiri atau membuatnya dengan AI.

Kelola glosarium

Instruksi Linguistik

Instruksi linguistik memberi tahu AI cara menulis: formal atau kasual, bentuk sapaan apa yang digunakan, cara menangani nama merek, konvensi khusus produk, atau apa pun yang mendefinisikan suara Anda. Tulis sekali dan instruksi tersebut akan diterapkan pada setiap terjemahan untuk bahasa tersebut.

Kelola instruksi linguistik

Aturan praktis: gunakan glosarium untuk apa sebuah kata harus menjadi apa, dan instruksi linguistik untuk bagaimana keseluruhan teks harus terdengar.

Apa Lagi yang Anda Dapatkan

Terjemahan Inkremental

Kami melacak string sumber Anda berdasarkan konten, jadi menjalankan ulang terjemahan hanya akan mengirimkan apa yang benar-benar berubah. Terjemahan yang sudah ada dan ditinjau tetap tidak tersentuh, diff Git Anda tetap kecil, dan Anda hanya ditagihkan untuk teks baru. Kami tidak menyimpan konten Anda; konten hanya di-hash untuk mendeteksi perubahan, sehingga string sumber Anda tetap pribadi.

165 Bahasa dan Setiap Format Umum

Terjemahkan ke dalam 165 bahasa, termasuk bahasa yang kurang umum didukung di mana penerjemah manusia sulit ditemukan. JSON, YAML, PO, XLIFF, ARB, Markdown, teks biasa, dan spesifikasi OpenAPI semuanya ditangani secara native — termasuk pesan ICU dan bentuk jamak CLDR lengkap.

Jaminan Format dan Berbagai LLM

Setiap hasil divalidasi terhadap sumbernya: jika placeholder, kunci, atau strukturnya hilang, potongan tersebut akan dicoba ulang secara otomatis. File besar dibagi menjadi potongan-potongan yang menjaga konteksnya, dan kami mengoperasikan beberapa LLM sehingga setiap bahasa dan jenis konten mendapatkan model yang menanganinya dengan paling baik.

Integrasi untuk Seluruh Tim Anda

Lokalisasi bukan hanya tugas pengembang. Bawa l10n.dev ke alat yang sudah digunakan tim Anda — plugin untuk Figma, Obsidian, ekstensi VS Code, paket NPM, MCP, dan REST API yang terdokumentasi.

Telusuri semua integrasi

Privasi Anda Penting

Kami tidak menyimpan data terjemahan Anda. Saat Anda menerjemahkan file di ruang kerja, Anda tetap memegang kendali penuh atas file tersebut — hapus kapan saja.

Kelola file Anda

Instan Khusus

Jika organisasi Anda memerlukan infrastruktur terisolasi, database dan penyimpanan Anda sendiri, deployment model Anda sendiri, atau jaminan kepatuhan khusus, kami dapat menjalankan l10n.dev sebagai instan khusus untuk Anda.

Baca tentang instan khusus

Paket Gratis dan Paket Berbayar

Setiap akun mendapatkan 10,000 karakter gratis setiap bulan. Tanpa biaya, tidak perlu kartu kredit — itu cukup untuk melokalisasi aplikasi kecil atau untuk mengevaluasi kualitas dengan benar sebelum Anda berkomitmen.

Jika Anda memerlukan lebih dari kuota bulanan gratis, Anda dapat membeli paket untuk menambah saldo karakter Anda. Gunakan alamat email yang terkait dengan pesanan untuk masuk dan mengakses manfaat Anda.

Paket yang tersedia:

  • 100K Characters
    Harga: $4.90
    Terjemahkan 100,000 karakter.*
  • 1M Characters
    Harga: $14.90
    Terjemahkan 1,000,000 karakter.*
  • 5M Characters
    Harga: $39.90
    Terjemahkan 5,000,000 karakter.*

*Setiap paket berlaku selama 90 hari, dan saldo yang tersisa akan diakumulasikan jika Anda membeli lagi sebelum masa berlakunya habis.

Bandingkan semua paket dan harga

Langkah Selanjutnya

Pilih langkah selanjutnya yang sesuai dengan cara Anda berencana untuk bekerja — atau cukup terjemahkan file dan lihat hasilnya sendiri.

Mengapa Memilih l10n.dev?

l10n.dev menggabungkan kekuatan AI dengan alat yang ramah pengguna untuk menyederhanakan proses lokalisasi Anda. Baik Anda seorang pengembang atau bagian dari tim lokalisasi, platform kami memastikan terjemahan yang akurat, efisien, dan terjangkau yang disesuaikan dengan kebutuhan Anda.