> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.
# Menggunakan GccAi di Immersive Translate
> Panduan lengkap untuk mengonfigurasi dan menggunakan layanan API GccAi di ekstensi browser Immersive Translate. Panduan ini membantu Anda menyiapkan API GccAi 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 GccAi sudah diperoleh**
Masuk ke [GccAi Console](https://gccai.heqingsong.uk/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)
> [!NOTE]
>
> **Tips:** Jika Anda belum memiliki akun GccAi, daftar terlebih dahulu di [GccAi](https://gccai.heqingsong.uk) dan dapatkan API key.
## 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
*Klik ikon Immersive Translate pada toolbar browser, lalu klik tombol "Settings" di kiri bawah*
## 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
*Temukan opsi "Translation Services" pada halaman pengaturan*
### 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 GccAi pada formulir konfigurasi
> [!NOTE]
>
> **Tips:** Immersive Translate mendukung layanan terjemahan kustom yang kompatibel dengan OpenAI, dan GccAi sepenuhnya kompatibel dengan format ini.
### 2.3 Konfigurasikan Informasi API GccAi
Isi informasi konfigurasi berikut:
| Konfigurasi | Nilai | Deskripsi |
| - | - | - |
| **Custom Translation Service Name** | `GccAi` | Dapat disesuaikan agar mudah dikenali |
| **APIKEY** | `sk-xxxxxxxxxxxx` | API key GccAi Anda |
| **Model** | `gpt-4o-mini` atau lainnya | Pilih dari daftar dropdown |
| **Custom API Endpoint** | `https://gccai.heqingsong.uk/api/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 [GccAi Console](https://gccai.heqingsong.uk/keys) dan diawali dengan `sk-`
> * **API Endpoint**: Harus menggunakan path lengkap `https://gccai.heqingsong.uk/api/v1/chat/completions`
> * **Pemilihan Model**: Direkomendasikan `gpt-4o-mini` (hemat biaya) atau `gpt-5` (kualitas terbaik)
> * **Frekuensi Permintaan**: Nilai 5 menyeimbangkan kecepatan dan stabilitas
*Isi konfigurasi layanan terjemahan kustom GccAi*
## 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 **GccAi** 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`
## 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`)
*Contoh hasil terjemahan halaman web Immersive Translate*
*Contoh fitur terjemahan teks yang dipilih*
### 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
*Contoh terjemahan bilingual dokumen PDF*
> [!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
### 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 (GccAi)
* **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.
### 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 **GccAi** dipilih pada dropdown "Translation Service"
* Jika GccAi 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 [GccAi Console](https://gccai.heqingsong.uk/keys)
3. **Periksa API Endpoint**:
* Path lengkap harus diisi: `https://gccai.heqingsong.uk/api/v1/chat/completions`
* Perhatikan bahwa yang digunakan bukan `/api/v1`, melainkan `/api/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 [GccAi Console](https://gccai.heqingsong.uk/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 + GccAi, 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 GccAi](https://gccai.heqingsong.uk)
* 📚 [Dokumentasi Immersive Translate](https://immersivetranslate.com/docs/)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Dukungan Teknis: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)
***
> **[Mulai Menggunakan GccAi](https://gccai.heqingsong.uk)**
>
> Daftar GccAi sekarang, dapatkan API key Anda, dan nikmati layanan terjemahan berkualitas tinggi!
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.