> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Menggunakan APIMart di Immersive Translate

> Panduan lengkap untuk mengonfigurasi dan menggunakan layanan API APIMart di ekstensi browser Immersive Translate. Panduan ini membantu Anda menyiapkan API APIMart di Immersive Translate untuk layanan terjemahan AI berkualitas tinggi.

## Prasyarat

Sebelum memulai, pastikan:

1. **Ekstensi Immersive Translate sudah terpasang**
   Pasang Immersive Translate dari:
   * [Chrome Web Store](https://chrome.google.com/webstore/detail/immersive-translate/bpoadfkcbjbfhfodiogcnhhhpibjhbnh)
   * [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/immersive-translate/amkbmndfnliijdhojkpoglbnaaahippg)
   * [Firefox Add-ons](https://addons.mozilla.org/firefox/addon/immersive-translate/)
   * [Situs resmi](https://immersivetranslate.com/)

2. **API Key APIMart sudah diperoleh**
   Masuk ke [APIMart Console](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

<Note>
  **Tips:** Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di [APIMart](https://apimart.ai) dan dapatkan API key.
</Note>

## Langkah 1: Buka Pengaturan Ekstensi

Setelah memasang ekstensi Immersive Translate:

1. Klik ikon **Immersive Translate** pada toolbar browser
2. Di bagian bawah panel popup, klik tombol **Settings** di sudut kiri bawah
3. Masuk ke halaman pengaturan Immersive Translate

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/immersive-translate/extension-icon.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=d668c16b215cddb6776c9abe4108b14c" alt="Panel ekstensi Immersive Translate" width="315" height="525" data-path="images/integrations/immersive-translate/extension-icon.png" />
</Frame>

<caption>*Klik ikon Immersive Translate pada toolbar browser, lalu klik tombol "Settings" di kiri bawah*</caption>

## Langkah 2: Konfigurasikan Layanan Terjemahan

### 2.1 Buka Pengaturan Layanan Terjemahan

Pada halaman pengaturan:

1. Temukan opsi **"Translation Services"** pada menu kiri
2. Klik untuk masuk ke halaman konfigurasi layanan terjemahan

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/immersive-translate/settings-services.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=01b21b857181b1b1ecbde3de87bf3d3a" alt="Pengaturan layanan terjemahan" width="1920" height="945" data-path="images/integrations/immersive-translate/settings-services.png" />
</Frame>

<caption>*Temukan opsi "Translation Services" pada halaman pengaturan*</caption>

### 2.2 Tambahkan Layanan Terjemahan Kustom

Pada halaman daftar layanan terjemahan:

1. Klik tombol **+ Add Custom Translation Service** di bagian atas
2. Isi informasi API APIMart pada formulir konfigurasi

<Note>
  **Tips:** Immersive Translate mendukung layanan terjemahan kustom yang kompatibel dengan OpenAI, dan APIMart sepenuhnya kompatibel dengan format ini.
</Note>

### 2.3 Konfigurasikan Informasi API APIMart

Isi informasi konfigurasi berikut:

| Konfigurasi                         | Nilai                                        | Deskripsi                                             |
| ----------------------------------- | -------------------------------------------- | ----------------------------------------------------- |
| **Custom Translation Service Name** | `APIMart`                                    | Dapat disesuaikan agar mudah dikenali                 |
| **APIKEY**                          | `sk-xxxxxxxxxxxx`                            | API key APIMart Anda                                  |
| **Model**                           | `gpt-4o-mini` atau lainnya                   | Pilih dari daftar dropdown                            |
| **Custom API Endpoint**             | `https://api.apimart.ai/v1/chat/completions` | Alamat endpoint API lengkap                           |
| **Max Requests Per Second**         | `5`                                          | Mengontrol frekuensi permintaan, direkomendasikan 3-5 |

<Note>
  **Catatan Konfigurasi:**

  * **APIKEY**: Harus diperoleh dari [APIMart Console](https://apimart.ai/keys) dan diawali dengan `sk-`
  * **API Endpoint**: Harus menggunakan path lengkap `https://api.apimart.ai/v1/chat/completions`
  * **Pemilihan Model**: Direkomendasikan `gpt-4o-mini` (hemat biaya) atau `gpt-5` (kualitas terbaik)
  * **Frekuensi Permintaan**: Nilai 5 menyeimbangkan kecepatan dan stabilitas
</Note>

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/immersive-translate/openai-config.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=f13741b5e53a3aa7fab6572f2ff329d2" alt="Konfigurasi layanan terjemahan kustom APIMart" width="1920" height="945" data-path="images/integrations/immersive-translate/openai-config.png" />
</Frame>

<caption>*Isi konfigurasi layanan terjemahan kustom APIMart*</caption>

## Langkah 3: Simpan dan Pilih Layanan Terjemahan

Setelah konfigurasi selesai:

1. Klik tombol **Save** di bagian bawah halaman konfigurasi
2. Kembali ke panel ekstensi, lalu pilih **APIMart** dari dropdown **Translation Service**
3. Anda dapat memilih gaya terjemahan (seperti "General") di **AI Expert**

### Model yang Direkomendasikan

Model yang berbeda cocok untuk skenario terjemahan yang berbeda:

**Model yang Tersedia:**

* **gpt-5** - model terbaru, kualitas terjemahan tertinggi ⭐ Direkomendasikan
* **gpt-4o** - terjemahan berkualitas tinggi, cepat
* **gpt-4o-mini** - hemat biaya, cocok untuk terjemahan berskala besar 💰 Nilai terbaik
* **claude-sonnet-4-5-20250929** - baik untuk terjemahan sastra
* **claude-haiku-4-5-20251001** - terjemahan cepat dan hemat biaya

<Tip>
  **Rekomendasi Skenario Terjemahan:**

  * 📚 **Dokumen Profesional, Dokumen Teknis:** `gpt-5`, `gpt-4o`
  * 📰 **Artikel Berita, Blog:** `gpt-4o`, `claude-sonnet-4-5-20250929`
  * 💬 **Penelusuran Web Sehari-hari:** `gpt-4o-mini`, `claude-haiku-4-5-20251001`
  * 🎨 **Karya Sastra, Konten Kreatif:** `claude-sonnet-4-5-20250929`, `gpt-5`
  * 💰 **Volume Tinggi, Sensitif Biaya:** `gpt-4o-mini`
</Tip>

## Langkah 4: Mulai Menggunakan Terjemahan

Setelah konfigurasi selesai, Anda dapat mulai menggunakan Immersive Translate:

### 4.1 Terjemahan Halaman Web

1. Buka halaman web berbahasa asing
2. Klik ikon Immersive Translate pada toolbar browser
3. Pilih **Translate this page** atau gunakan pintasan (default: `Alt+A`)

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/immersive-translate/webpage-translation.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=10a874b53d9f0539b0021b3ff6b32dfe" alt="Contoh terjemahan halaman web" width="1920" height="945" data-path="images/integrations/immersive-translate/webpage-translation.png" />
</Frame>

<caption>*Contoh hasil terjemahan halaman web Immersive Translate*</caption>

<caption>*Contoh fitur terjemahan teks yang dipilih*</caption>

### 4.3 Terjemahan PDF

Immersive Translate mendukung terjemahan file PDF online:

1. Buka file PDF di browser Anda (PDF online)
2. Klik ikon Immersive Translate untuk membuka panel ekstensi
3. Klik tombol **Click to translate PDF (Alt+A)**
4. Tunggu hingga terjemahan selesai; PDF akan menampilkan perbandingan bilingual

<Frame>
  <img src="https://mintcdn.com/apicore/0c3FfTpBvR13Ca4x/images/integrations/immersive-translate/pdf-translation.png?fit=max&auto=format&n=0c3FfTpBvR13Ca4x&q=85&s=11f28aec1dfe280e1cc602a9d1d1624d" alt="Terjemahan bilingual dokumen PDF" width="1914" height="975" data-path="images/integrations/immersive-translate/pdf-translation.png" />
</Frame>

<caption>*Contoh terjemahan bilingual dokumen PDF*</caption>

<Note>
  **Dukungan Terjemahan PDF:**

  * ✅ Mendukung file PDF online (seperti planetebook.com, arXiv.org, dan lainnya)
  * ✅ Mempertahankan tata letak asli dan menampilkan perbandingan bilingual
  * ✅ Mendukung pemilihan area terjemahan
  * ❌ PDF lokal perlu diunggah ke web viewer
</Note>

### 4.4 Terjemahan Subtitle Video

Mendukung terjemahan subtitle real-time untuk platform video populer:

1. Buka YouTube, Netflix, atau platform video lainnya
2. Putar video; Immersive Translate akan mengenali subtitle secara otomatis
3. Sistem akan menghasilkan tampilan subtitle bilingual secara otomatis

**Platform yang Didukung:**

* 🎬 YouTube
* 📺 Netflix
* 🎥 Coursera
* 📹 Udemy
* 🎓 edX

## Fitur Lanjutan

### Aturan Terjemahan Kustom

Opsi personalisasi yang kaya dapat dikonfigurasi di pengaturan:

**Pengaturan Dasar:**

* **Translation Service** - pilih layanan terjemahan default (APIMart)
* **AI Expert** - pilih gaya terjemahan (General, Professional, Literary, dan lainnya)
* **AI Terminology** - kelola terjemahan terminologi profesional

**Opsi Lanjutan:**

* **Website Rules** - atur aturan terjemahan otomatis untuk situs tertentu
* **Translation Style** - sesuaikan warna, font, dan gaya tampilan terjemahan lainnya
* **Mouse Hover Settings** - konfigurasikan Ctrl + hover mouse untuk menampilkan teks asli
* **Word Selection Translation** - atur perilaku terjemahan setelah memilih teks
* **Input Box Enhancement** - aktifkan terjemahan real-time di kotak input

### Pintasan Keyboard

Immersive Translate menyediakan pintasan keyboard yang praktis:

| Fungsi                         | Pintasan Default             | Deskripsi                                     |
| ------------------------------ | ---------------------------- | --------------------------------------------- |
| **Translate Webpage/PDF**      | `Alt+A`                      | Mulai menerjemahkan halaman atau PDF saat ini |
| **Show Original**              | `Alt+A` lagi                 | Beralih untuk menampilkan teks asli           |
| **Word Translation Panel**     | `Alt+W`                      | Buka jendela terjemahan teks yang dipilih     |
| **Switch Translation Service** | Konfigurasikan di pengaturan | Beralih cepat antar-layanan terjemahan        |

<Tip>
  **Tips Pintasan:** Semua pintasan dapat disesuaikan di pengaturan ekstensi. Pilih kombinasi tombol yang paling sesuai dengan kebiasaan Anda.
</Tip>

### Mode Terjemahan

Immersive Translate menawarkan beberapa mode tampilan terjemahan yang fleksibel:

| Mode                     | Deskripsi                                                  | Kasus Penggunaan                            |
| ------------------------ | ---------------------------------------------------------- | ------------------------------------------- |
| **Bilingual Comparison** | Paragraf asli dan terjemahan ditampilkan bergantian        | Belajar, membaca perbandingan 📚            |
| **Mouse Hover**          | Menampilkan terjemahan saat kursor berada di atas paragraf | Melihat terjemahan sesekali 👆              |
| **Only This Website**    | Mengaktifkan terjemahan hanya pada situs saat ini          | Penggunaan sering pada situs tertentu 🌐    |
| **Word Selection**       | Menampilkan terjemahan setelah teks dipilih                | Terjemahan presisi untuk konten tertentu ✍️ |

## FAQ

### Q1: Terjemahan tidak berfungsi setelah konfigurasi?

**Solusi:**

1. **Periksa Pilihan Layanan Terjemahan**:
   * Buka panel ekstensi dan pastikan **APIMart** dipilih pada dropdown "Translation Service"
   * Jika APIMart tidak terlihat, kembali ke halaman pengaturan untuk memeriksa apakah konfigurasi sudah tersimpan

2. **Periksa API Key**:
   * Pastikan APIKEY benar dan diawali dengan `sk-`
   * Periksa apakah key valid dan memiliki saldo di [APIMart Console](https://apimart.ai/keys)

3. **Periksa API Endpoint**:
   * Path lengkap harus diisi: `https://api.apimart.ai/v1/chat/completions`
   * Perhatikan bahwa yang digunakan bukan `/v1`, melainkan `/v1/chat/completions`

4. **Periksa Nama Model**:
   * Pastikan nama model benar (seperti `gpt-4o-mini`, `gpt-5`)
   * Nama model peka huruf besar-kecil

### Q2: Terjemahan lambat atau timeout?

**Solusi:**

1. **Sesuaikan Max Requests Per Second**:
   * Pada konfigurasi, turunkan "Max Requests Per Second" menjadi `3`
   * Hindari terlalu banyak permintaan bersamaan yang dapat menyebabkan timeout

2. **Beralih ke Model yang Lebih Cepat**:
   * Gunakan `gpt-4o-mini` (cepat dan ekonomis)
   * Atau gunakan `claude-haiku-4-5-20251001`

3. **Periksa Koneksi Jaringan**:
   * Pastikan jaringan stabil dan hindari koneksi yang sering terputus
   * Untuk halaman besar, disarankan menerjemahkan per bagian

4. **Nonaktifkan Fitur yang Tidak Diperlukan**:
   * Nonaktifkan sementara "Enable AI Illustration" dan fitur peningkatan lainnya
   * Kurangi jumlah panggilan API

### Q3: Kualitas terjemahan kurang ideal?

**Solusi:**

1. **Pilih Model Berkualitas Lebih Tinggi**:
   * Gunakan `gpt-5` (terbaru dan paling kuat) atau `gpt-4o` (kualitas tinggi)
   * Untuk konten sastra dan profesional, direkomendasikan `claude-sonnet-4-5-20250929`

2. **Sesuaikan Pengaturan AI Expert**:
   * Pilih "AI Expert" yang sesuai pada panel ekstensi
   * Pilih "Professional" untuk dokumen teknis, "General" untuk konten sehari-hari

3. **Gunakan Pustaka Terminologi**:
   * Konfigurasikan "AI Terminology" di pengaturan
   * Tambahkan terjemahan pilihan untuk istilah profesional agar konsisten

4. **Aktifkan Peningkatan Konteks AI**:
   * Aktifkan "AI Smart Context" pada konfigurasi layanan kustom
   * Memberikan pemahaman konteks yang lebih akurat

### Q4: Beberapa situs tidak dapat diterjemahkan?

**Solusi:**

1. **Periksa Kompatibilitas Situs**:
   * Beberapa situs dengan pemuatan dinamis mungkin perlu di-refresh
   * SPA mungkin memerlukan pemicu terjemahan manual

2. **Tambahkan Aturan Situs**:
   * Tambahkan konfigurasi situs tertentu pada "Website Rules" di pengaturan
   * Tentukan area terjemahan dan area pengecualian

3. **Coba Mode Terjemahan Berbeda**:
   * Beralih ke mode "Mouse Hover" atau "Word Selection"
   * Beberapa situs bekerja lebih baik dalam mode tertentu

### Q5: Bagaimana melihat konsumsi terjemahan?

Masuk ke [APIMart Console](https://apimart.ai/overview) untuk melihat statistik terperinci:

* 📊 **Statistik Panggilan API** - lihat jumlah dan frekuensi panggilan secara real-time
* 💰 **Rincian Biaya** - catatan biaya terperinci untuk setiap panggilan
* 📈 **Tren Penggunaan** - lihat penggunaan berdasarkan tanggal/model
* 🔍 **Log Permintaan** - catatan permintaan dan respons terperinci

## Tips Penggunaan

### 1. Pemilihan Layanan Terjemahan yang Cerdas

Pilih model yang sesuai untuk berbagai skenario:

* **📚 Makalah Akademik, Dokumen Teknis**: gunakan `gpt-5` untuk akurasi
* **📰 Artikel Berita, Blog**: gunakan `gpt-4o` untuk menyeimbangkan kualitas dan kecepatan
* **💬 Media Sosial, Penelusuran Harian**: gunakan `gpt-4o-mini` untuk menghemat biaya
* **🎨 Karya Sastra, Konten Kreatif**: gunakan `claude-sonnet-4-5-20250929`

### 2. Konfigurasikan Terjemahan Otomatis Situs

Atur aturan terjemahan otomatis untuk situs yang sering dikunjungi:

1. Buka Settings → **Website Rules**
2. Tambahkan domain situs (seperti `github.com`)
3. Atur ke "Always Translate" atau "Never Translate"
4. Setelah disimpan, aturan berlaku otomatis saat mengunjungi situs tersebut

### 3. Gunakan Terjemahan Teks yang Dipilih untuk Kueri Presisi

Untuk konten tertentu di dalam blok teks besar:

1. Aktifkan fitur "Word Selection Translation"
2. Pilih teks yang perlu diterjemahkan
3. Lihat hasil terjemahan yang presisi
4. Hindari menerjemahkan seluruh halaman agar hemat panggilan API

### 4. Optimalkan Kualitas Terjemahan

**Konfigurasikan Pustaka Terminologi**:

* Tambahkan istilah profesional di pengaturan
* Pastikan konsistensi terjemahan terminologi teknis
* Mendukung beberapa kategori pustaka terminologi

**Pilih AI Expert yang Sesuai**:

* Pilih "Professional" atau "Technical" untuk dokumen teknis
* Pilih "General" untuk konten sehari-hari
* Pilih "Literary" atau "Creative" untuk karya sastra

### 5. Hemat Biaya API

**Strategi Kontrol Biaya**:

* ✅ Gunakan `gpt-4o-mini` sebagai model default untuk penelusuran harian
* ✅ Beralih ke `gpt-5` hanya untuk dokumen penting
* ✅ Konfigurasikan "Max Requests Per Second" ke 3-5 untuk menghindari limit
* ✅ Gunakan fitur "Only This Website" untuk mengontrol cakupan terjemahan
* ✅ Pilih rentang halaman yang diperlukan saat menerjemahkan PDF
* ❌ Hindari sering me-refresh halaman yang sudah diterjemahkan

## Fitur

Dengan Immersive Translate + APIMart, Anda dapat:

* 🌐 **Terjemahan Halaman Web** - tampilan perbandingan bilingual, mempertahankan tata letak asli
* 📄 **Terjemahan PDF** - mendukung terjemahan dokumen PDF online
* 🎬 **Subtitle Video** - subtitle bilingual untuk YouTube, Netflix, dan platform lainnya
* ✍️ **Terjemahan Teks yang Dipilih** - pilih dan terjemahkan untuk memahami dengan cepat
* 📧 **Peningkatan Input** - terjemahan langsung di kotak input
* 📱 **Dukungan Platform Lengkap** - Chrome, Edge, Firefox, Safari, dan lainnya
* 🎨 **Gaya Kustom** - sesuaikan tampilan terjemahan
* ⚡ **Operasi Cepat** - dukungan pintasan keyboard yang lengkap

## Dukungan dan Bantuan

Jika mengalami masalah saat menggunakan:

* 📚 [Pusat Dokumentasi APIMart](https://docs.apimart.ai)
* 📚 [Dokumentasi Immersive Translate](https://immersivetranslate.com/docs/)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Dukungan Teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mulai Menggunakan APIMart" icon="rocket" href="https://apimart.ai">
  Daftar APIMart sekarang, dapatkan API key Anda, dan nikmati layanan terjemahan berkualitas tinggi!
</Card>