API Translator: Cara Menerjemahkan Deskripsi Produk Toko Online Otomatis (curl, Node.js, Python)
Oleh Tim APIPedia, Tim Engineering APIPedia · Terbit · Diperbarui · 10 menit baca
API Translator APIPedia menerjemahkan hingga 50 teks sekaligus lewat POST /v1/translate. Contoh katalog toko online dengan curl, Node.js, dan Python.
![Sampul APIPedia: judul "Terjemahkan katalog toko sekali kirim" dengan chip POST /v1/translate, maks. 50 item, dan 5.000 karakter, serta dua kartu: input text[] berbahasa Indonesia dan output translatedText[] berbahasa Inggris lewat provider google dalam 988 ms.](https://supabase.apipedia.id/storage/v1/object/public/blog-media/posts/2026/11/api-translator-deskripsi-produk-cover-v-1e45fdeb.webp)
API Translator APIPedia menerjemahkan satu teks atau hingga 50 teks sekaligus lewat satu request POST /v1/translate, dengan bahasa sumber yang bisa dideteksi otomatis. Hasilnya ada di field translatedText, dalam urutan yang sama dengan teks yang Anda kirim.
Tutorial ini memakai kasus toko online yang ingin menampilkan katalog dalam bahasa Inggris: nama produk, deskripsi, dan catatan pengiriman diterjemahkan dari backend, lalu disimpan di database. Anda akan melihat contoh curl, Node.js, dan Python, respons nyata dari uji kami pada 15 November 2026, serta kapan memakai mode AI.
Ringkasan cepat: apa yang perlu Anda tahu?
Produk Translator punya dua endpoint: satu untuk menerjemahkan, satu untuk melihat daftar bahasa dan provider. Tabel berikut merangkum intinya.
| Item | Detail |
|---|---|
| Terjemahkan | POST https://api.apipedia.id/v1/translate |
| Daftar bahasa dan provider | GET https://api.apipedia.id/v1/translate/languages |
| Body wajib | text (string atau array string) dan target (mis. "en") |
| Body opsional | source (default auto), provider (default auto), serta model, formality, instructions untuk mode AI |
| Batas | 5.000 karakter per request, maksimal 50 item dalam satu array |
| Autentikasi | Header Authorization: Bearer apk_xxx |
| Provider mode auto | google, lalu google-dict, lalu mymemory |
| Hasil | translatedText, source, target, provider, attempts |
Masalah apa yang diselesaikan API Translator?
API ini menghilangkan pekerjaan menyalin deskripsi produk satu per satu ke alat terjemahan. Toko dengan ratusan produk biasanya menunda versi bahasa Inggris karena menerjemahkan manual memakan waktu, dan setiap perubahan deskripsi harus diterjemahkan ulang.
Dengan satu endpoint di backend, terjemahan menjadi bagian dari alur simpan produk. Admin mengetik deskripsi dalam bahasa Indonesia, sistem Anda mengirimnya ke API, lalu hasilnya disimpan sebagai draf versi Inggris yang tinggal diperiksa.
Mode auto juga mengurangi satu sumber gangguan: bila provider pertama gagal karena diblokir, kehabisan kuota, atau timeout, API mencoba provider berikutnya tanpa Anda menulis logika cadangan sendiri.

Apa yang perlu disiapkan sebelum mulai?
Anda hanya butuh satu kunci API APIPedia. Daftar atau masuk di console.apipedia.id, buka menu Token API, lalu buat kunci baru. Kunci berawalan apk_ dan dikirim lewat header Authorization: Bearer apk_xxx.
Simpan kunci di variabel lingkungan server, misalnya APIPEDIA_KEY, dan panggil API dari backend. Produk Translator tercatat di tier Free pada katalog. Mode AI berbeda: mode itu memotong kredit AI dan membutuhkan kunci dengan scope AI Gateway.
Langkah 1: bagaimana menerjemahkan satu teks dengan curl?
Kirim text dan target sebagai JSON ke POST /v1/translate. Contoh berikut menerjemahkan satu kalimat deskripsi produk ke bahasa Inggris.
curl -s -X POST https://api.apipedia.id/v1/translate \
-H "Authorization: Bearer apk_xxx" \
-H "Content-Type: application/json" \
-d '{"text": "Keripik tempe renyah khas Malang, digoreng tanpa pengawet.", "target": "en"}'
Bila text berupa string, translatedText juga berupa string. Field source boleh dikosongkan; API mendeteksi bahasanya dan melaporkannya di respons. Kode bahasa yang umum dipakai antara lain id, en, jv (Jawa), su (Sunda), ms, ar, ja, ko, dan zh-CN.
Langkah 2: bagaimana menerjemahkan banyak teks dalam satu request?
Kirim text sebagai array, dan API mengembalikan array hasil dalam urutan yang sama. Cara ini lebih hemat daripada satu request per kalimat, karena tiga field produk cukup satu panggilan.
curl -s -X POST https://api.apipedia.id/v1/translate \
-H "Authorization: Bearer apk_xxx" \
-H "Content-Type: application/json" \
-d '{
"text": [
"Keripik tempe renyah khas Malang, digoreng tanpa pengawet.",
"Berat bersih 250 gram, tahan 3 bulan di suhu ruang.",
"Gratis ongkir untuk pembelian minimal 5 bungkus."
],
"target": "en"
}'
Respons nyata dari uji kami:
{
"is_success": true,
"message": "Text translated (provider google).",
"data": {
"translatedText": [
"Typical Malang crispy tempe chips, fried without preservatives.",
"Net weight 250 grams, lasts 3 months at room temperature.",
"Free shipping for minimum purchase of 5 packs."
],
"source": "id",
"target": "en",
"provider": "google",
"attempts": [
{ "provider": "google", "status": "success", "ms": 988 }
]
}
}
| Field | Arti |
|---|---|
translatedText | Hasil terjemahan. String bila input string, array bila input array. |
source | Bahasa sumber. Pada uji ini terdeteksi id walau tidak dikirim. |
target | Bahasa tujuan yang Anda minta. |
provider | Provider yang akhirnya menghasilkan terjemahan. |
attempts | Riwayat percobaan per provider: nama, status, dan lama proses dalam milidetik. |
Satu request dibatasi 5.000 karakter dan 50 item. Katalog yang lebih besar perlu dipecah menjadi beberapa batch, seperti pada langkah berikutnya.
Langkah 3: bagaimana memasangnya di backend Node.js?
Buat satu fungsi yang membagi teks menjadi batch sesuai batas, lalu menggabungkan hasilnya kembali. Contoh ini berjalan di Node.js 18 ke atas tanpa dependensi tambahan.
const BASE = "https://api.apipedia.id/v1";
const headers = {
Authorization: `Bearer ${process.env.APIPEDIA_KEY}`, // apk_xxx
"Content-Type": "application/json",
};
// Batas API: 50 item dan 5.000 karakter per request.
function bagiBatch(daftarTeks, maxItem = 50, maxKarakter = 5000) {
const batches = [];
let batch = [];
let jumlah = 0;
for (const teks of daftarTeks) {
if (teks.length > maxKarakter) throw new Error("Satu teks melebihi 5.000 karakter");
if (batch.length === maxItem || jumlah + teks.length > maxKarakter) {
batches.push(batch);
batch = [];
jumlah = 0;
}
batch.push(teks);
jumlah += teks.length;
}
if (batch.length) batches.push(batch);
return batches;
}
export async function terjemahkan(daftarTeks, target = "en", source = "id") {
const hasil = [];
for (const batch of bagiBatch(daftarTeks)) {
const res = await fetch(`${BASE}/translate`, {
method: "POST",
headers,
body: JSON.stringify({ text: batch, target, source }),
});
const body = await res.json();
if (!body.is_success) throw new Error(`HTTP ${res.status}: ${body.message}`);
hasil.push(...body.data.translatedText); // urutan sama dengan input
}
return hasil;
}
// Contoh: terjemahkan tiga field satu produk, lalu simpan sebagai draf.
const produk = {
nama: "Keripik tempe renyah khas Malang",
deskripsi: "Digoreng tanpa pengawet, berat bersih 250 gram.",
pengiriman: "Gratis ongkir untuk pembelian minimal 5 bungkus.",
};
const [nama, deskripsi, pengiriman] = await terjemahkan(Object.values(produk));
console.log({ nama, deskripsi, pengiriman });
Karena hasil selalu berurutan sesuai input, Anda bisa memetakan kembali terjemahan ke field asalnya tanpa penanda tambahan. Simpan hasilnya di kolom terpisah, misalnya deskripsi_en, beserta penanda bahwa teks itu hasil mesin dan belum diperiksa.
Langkah 4: bagaimana contoh yang sama di Python?
Di Python, kirim JSON dengan requests dan baca translatedText dari respons. Polanya sama dengan versi Node.js.
import os
import requests # pip install requests
BASE = "https://api.apipedia.id/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['APIPEDIA_KEY']}"} # apk_xxx
def bagi_batch(daftar_teks, max_item=50, max_karakter=5000):
batch, jumlah = [], 0
for teks in daftar_teks:
if len(teks) > max_karakter:
raise ValueError("Satu teks melebihi 5.000 karakter")
if len(batch) == max_item or jumlah + len(teks) > max_karakter:
yield batch
batch, jumlah = [], 0
batch.append(teks)
jumlah += len(teks)
if batch:
yield batch
def terjemahkan(daftar_teks, target="en", source="id"):
hasil = []
for batch in bagi_batch(daftar_teks):
res = requests.post(
f"{BASE}/translate",
headers=HEADERS,
json={"text": batch, "target": target, "source": source},
timeout=30,
)
body = res.json()
if not body.get("is_success"):
raise RuntimeError(f"HTTP {res.status_code}: {body.get('message')}")
hasil.extend(body["data"]["translatedText"])
return hasil
if __name__ == "__main__":
teks = [
"Keripik tempe renyah khas Malang, digoreng tanpa pengawet.",
"Berat bersih 250 gram, tahan 3 bulan di suhu ruang.",
]
for asli, inggris in zip(teks, terjemahkan(teks)):
print(asli, "->", inggris)
Kapan memakai mode AI, bukan mode auto?
Pakai mode AI ketika teks Anda berisi markdown, placeholder seperti {nama}, atau butuh gaya bahasa tertentu. Menurut katalog, mode ini mempertahankan format, markdown, dan placeholder {x}, serta menerima pengaturan formality dan instructions.

Untuk memakainya, set provider ke "ai" dan isi model dengan id model dari GET /v1/ai/models. Nilai MODEL_ANDA di bawah adalah pengganti, bukan nama model sungguhan.
curl -s -X POST https://api.apipedia.id/v1/translate \
-H "Authorization: Bearer apk_xxx" \
-H "Content-Type: application/json" \
-d '{
"text": "Halo {nama}, pesanan **#{nomor}** sedang dikemas.",
"target": "en",
"provider": "ai",
"model": "MODEL_ANDA",
"formality": "formal",
"instructions": "Pertahankan nama produk dalam bahasa Indonesia."
}'
| Hal | Mode auto | Mode AI |
|---|---|---|
Field model | Tidak perlu | Wajib |
| Format dan placeholder | Tidak dijamin utuh | Dipertahankan |
| Gaya bahasa | Tidak bisa diatur | formality dan instructions (maks. 300 karakter) |
| Biaya | Mengikuti kuota request biasa | Memotong kredit AI |
| Cache | Ya | Tidak |
Aturan praktisnya: mulai dari mode auto untuk teks polos, dan pindah ke mode AI hanya untuk template pesan, konten ber-markdown, atau teks yang nadanya penting.
Apa batas API Translator ini?
API ini menghasilkan terjemahan mesin, jadi hasilnya perlu diperiksa manusia sebelum tayang di halaman yang penting. Pada uji kami, "keripik tempe khas Malang" menjadi "Typical Malang crispy tempe chips": bisa dipahami, tetapi belum tentu pilihan kata yang Anda inginkan untuk etalase.
- Bukan untuk dokumen hukum atau medis. Kontrak, label komposisi, dan klaim kesehatan tetap perlu penerjemah yang berwenang.
- Provider mode auto bisa berganti. Dua request serupa bisa dilayani provider berbeda, jadi gaya terjemahannya dapat sedikit berbeda. Lihat field
provider. - Satu request maksimal 5.000 karakter dan 50 item. Deskripsi panjang perlu dipecah per paragraf.
- Daftar di
/translate/languagesadalah contoh 40 bahasa umum. Kode BCP-47 lain yang didukung provider, misalnyapt-BR, juga diterima.
Kesalahan umum apa yang perlu dihindari?
Kesalahan paling sering adalah menerjemahkan ulang teks yang sama setiap kali halaman dibuka. Terjemahkan sekali saat produk disimpan, lalu sajikan dari database. Periksa juga hal-hal berikut.
- Satu request per kalimat. Kirim array agar puluhan teks selesai dalam satu panggilan.
- Tidak mengisi
sourceuntuk teks pendek. Kata tunggal seperti nama varian bisa salah terdeteksi. Bila Anda tahu bahasanya, kirim"source": "id". - Mengirim HTML utuh di mode auto. Tidak ada jaminan tag tetap utuh. Kirim teksnya saja, atau pakai mode AI untuk konten berformat.
- Menerjemahkan nama merek dan kode SKU. Pisahkan dari teks sebelum dikirim, lalu gabungkan kembali.
- Memanggil dari browser. Kunci
apk_xxxakan terbaca siapa pun. Panggil dari backend. - Mengabaikan
is_success. Bila nilainyafalse, bacamessage, jangan menyimpan hasil kosong ke database. - Langsung menayangkan hasil. Simpan sebagai draf dan beri admin tombol periksa.
Kode status yang perlu ditangani
| Status | Arti | Tindakan |
|---|---|---|
| 200 | Terjemahan selesai | Baca translatedText |
| 400 | Parameter atau body tidak valid | Baca message, yang menyebut field bermasalah |
| 401 | Token tidak ada, tidak dikenal, atau kedaluwarsa | Periksa header Authorization |
| 403 | Kunci tidak punya scope untuk endpoint ini | Ubah scope kunci di halaman Token |
| 429 | Batas request terlampaui | Tunggu, lalu ulangi dengan jeda |
Pertanyaan yang sering diajukan
Apakah API Translator APIPedia gratis?
Produk Translator tercatat di tier Free pada katalog APIPedia. Mode AI adalah pengecualian: biayanya dipotong dari kredit AI sesuai model yang Anda pilih.
Bahasa apa saja yang didukung?
Endpoint GET /v1/translate/languages mengembalikan 40 bahasa umum, termasuk Indonesia, Inggris, Jawa, Sunda, Melayu, Arab, Jepang, Korea, dan Mandarin. Kode BCP-47 lain yang didukung provider juga diterima.
Apakah bisa menerjemahkan ke bahasa Jawa atau Sunda?
Bisa. Kode jv untuk Jawa dan su untuk Sunda ada di daftar bahasa. Kualitas terjemahan bahasa daerah umumnya di bawah bahasa besar, jadi periksa hasilnya.
Bagaimana tahu provider mana yang menerjemahkan teks saya?
Baca field provider di respons. Field attempts memuat riwayat lengkapnya, termasuk provider yang gagal dan lama tiap percobaan dalam milidetik.
Apakah placeholder seperti {nama} aman?
Di mode AI, placeholder {x} dan markdown dipertahankan. Di mode auto tidak ada jaminan itu, jadi pakai mode AI untuk template pesan.
Langkah berikutnya: coba di konsol
Katalog dua bahasa cukup butuh satu fungsi terjemahkan di backend dan satu kolom tambahan di tabel produk. Buat kunci di console.apipedia.id, jalankan contoh curl di atas dengan deskripsi produk Anda sendiri, lalu pasang fungsi itu di alur simpan produk.
Untuk melengkapi toko yang melayani pembeli luar negeri, baca juga API kurs rupiah untuk menampilkan harga dalam mata uang lain dan API cek ongkir untuk estimasi biaya kirim. Bila asisten AI Anda perlu menerjemahkan teks, ikuti panduan menghubungkan APIPedia ke Claude lewat MCP.
Topik: #api translator #terjemahan #toko online #tutorial #nodejs #python
Tentang penulis
Tim APIPedia — Tim Engineering APIPedia
Tim engineering di balik APIPedia yang membangun dan memelihara API data Indonesia - ongkir, OCR KTP, data wilayah, BMKG, hingga server MCP - dan menulis panduan integrasinya dari pengalaman langsung.