> ## 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 Cherry Studio
> Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API GccAi di klien desktop Cherry Studio. Panduan ini membantu Anda mengatur API GccAi di Cherry Studio untuk mengakses beragam sumber daya model AI.
## Prasyarat
Sebelum memulai, pastikan:
1. **Cherry Studio is installed**\
Unduh dan instal versi yang sesuai untuk sistem operasi Anda dari [situs resmi Cherry Studio](https://cherry-ai.com/)
2. **API key GccAi sudah diperoleh**\
Masuk ke [Konsol GccAi](https://gccai.heqingsong.uk/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)
> [!NOTE]
>
> **Tips:** Jika Anda belum memiliki akun GccAi, daftar di [GccAi](https://gccai.heqingsong.uk) dan dapatkan API key terlebih dahulu.
## Langkah 1: Buka Pengaturan Cherry Studio
Setelah menjalankan Cherry Studio, buka halaman pengaturan:
1. Klik ikon **⚙️ Settings** (ikon roda gigi) di sudut kanan atas
2. Or use keyboard shortcuts:
* Windows/Linux: `Ctrl + ,`
* macOS: `Cmd + ,`
*Antarmuka utama Cherry Studio, klik ikon roda gigi di kanan atas untuk membuka pengaturan*
## Langkah 2: Tambahkan Platform Model GccAi
### 2.1 Akses Manajemen Layanan Model
Di halaman pengaturan:
1. Temukan opsi **Model Service** di menu kiri
2. Klik untuk masuk ke halaman manajemen layanan model
*Temukan opsi "Model Service" di menu kiri halaman pengaturan*
### 2.2 Tambahkan Penyedia GccAi
1. Di bagian bawah halaman layanan model, klik tombol **"+ Add"**
*Klik "+ Add" untuk membuka dialog penambahan penyedia*
2. Di dialog **"Add Provider"**, isi:
* **Provider Name**: `GccAi` (dapat disesuaikan)
* **Provider Type**: Pilih `OpenAI`
3. Klik tombol **"Confirm"**
### 2.3 Konfigurasikan Informasi API GccAi
Setelah menambahkan penyedia, isi informasi API di area konfigurasi kanan:
| Kolom | Nilai |
| - | - |
| **API Key** | API key GccAi Anda (`sk-xxxxxxxxxxxx`) |
| **API URL** | `https://gccai.heqingsong.uk` |
> [!NOTE]
>
> **Penting:**
>
> * API URL harus `https://gccai.heqingsong.uk` (jangan sertakan `/v1` atau path lain)
> * API Key harus diperoleh dari konsol GccAi dan diawali dengan `sk-`
> * Setelah mengisi, Anda dapat mengeklik tombol **"Test"** untuk menguji koneksi
*Isi API key dan API URL, pastikan status penyedia GccAi ON (saklar hijau)*
## Langkah 3: Tambahkan dan Kelola Model
### 3.1 Buka Manajemen Model
Setelah mengonfigurasi penyedia GccAi:
1. Pastikan saklar penyedia GccAi di kanan atas berada pada **ON** (hijau)
2. Di area konfigurasi kanan, temukan bagian **"Models"**
3. Klik tombol **"Manage"** untuk membuka jendela pemilihan model
*Klik tombol "Manage" untuk membuka jendela pemilihan model GccAi*
### 3.2 Tambahkan Model yang Diinginkan
Di jendela pemilihan model:
1. Gunakan kotak pencarian untuk menemukan model tertentu
2. Gunakan tab kategori di bagian atas untuk memfilter: **All**, **Reasoning**, **Vision**, **Web**, **Free**, **Embedding**, **Rerank**, **Tool**
3. Temukan model yang diinginkan lalu klik tombol **+** di kanan untuk menambahkannya:
* `gpt-4o` / `chatgpt-4o` - model OpenAI GPT-4o
* `gpt-4o-mini` - versi yang lebih cepat dan ekonomis
* `claude-3` series - Claude 3 models (with multiple variants)
* `claude_code_sonnet-4` - Claude Code Sonnet 4
* `claude_code_haiku-4` - Claude Code Haiku 4
* `gemini-2.0-flash-exp` - Google Gemini 2.0 Flash
*Model yang ditambahkan akan muncul di kanan dan dapat diperluas untuk melihat varian tertentu*
4. Setelah menambahkan semua model yang diinginkan, tutup jendela pemilihan model
> [!TIP]
>
> **Model yang Direkomendasikan:**
>
> * 💰 **Cost-effective:** `gpt-4o-mini`, `claude_code_haiku-4`
> * 🚀 **High-performance:** `gpt-4o` / `chatgpt-4o`, `claude_code_sonnet-4`
> * 🎨 **Multimodal:** `claude-3` series, `gemini-2.0-flash-exp`
## Langkah 4: Mulai Chat
Setelah konfigurasi, Anda dapat mulai menggunakannya:
1. Kembali ke antarmuka utama, klik **"+"** di bagian atas atau pilih chat yang sudah ada
2. Di bagian atas halaman chat, klik pemilih model
3. Pilih model di bawah penyedia **GccAi**
4. Mulai chat dengan AI!
*Buat chat baru lalu pilih penyedia dan model GccAi*
*Cherry Studio chat interface example*
## FAQ
### Q1: Tidak dapat terhubung ke layanan GccAi?
**Solusi:**
1. **Periksa Base URL**:
* Pastikan Base URL adalah `https://gccai.heqingsong.uk`
* Do not add `/v1` suffix
2. **Verifikasi API Key**:
* Pastikan API Key benar dan diawali dengan `sk-`
* Periksa apakah key valid di [Konsol GccAi](https://gccai.heqingsong.uk/keys)
3. **Periksa Koneksi Jaringan**:
* Pastikan Anda dapat mengakses `https://gccai.heqingsong.uk`
* Anda mungkin perlu mengonfigurasi proxy jika berada di Tiongkok
### Q2: Daftar model kosong atau tidak dapat diperbarui?
**Solusi:**
1. **Manually Add Models**:
* Jika refresh otomatis gagal, Anda dapat menambahkan model umum secara manual
* Di manajemen model, masukkan nama model secara manual (misalnya `gpt-4o`)
2. **Check API Permissions**:
* Pastikan API Key Anda memiliki izin untuk mengakses daftar model
* Hubungi dukungan GccAi untuk memeriksa status akun
### Q3: Pesan errors during conversation?
**Error umum dan solusinya:**
| Pesan Error | Penyebab | Solusi |
| - | - | - |
| `401 Unauthorized` | API Key tidak valid atau kedaluwarsa | Dapatkan API Key baru dan perbarui konfigurasi |
| `429 Too Many Requests` | Batas laju permintaan terlampaui | Tunggu sebentar lalu coba lagi |
| `500 Internal Server Error` | Masalah server sementara | Tunggu beberapa menit lalu coba lagi |
| `insufficient_quota` | Saldo akun tidak mencukupi | Isi ulang saldo di konsol |
### Q4: Bagaimana melihat penggunaan dan biaya API?
Masuk ke [Konsol GccAi](https://gccai.heqingsong.uk/overview) untuk melihat:
* 📊 Statistik panggilan API
* 💰 Detail biaya
* 📈 Grafik tren penggunaan
## Fitur
Dengan Cherry Studio + GccAi, Anda dapat:
* 💬 **Percakapan Multi-Model** - Gunakan model AI berbeda dalam antarmuka yang sama
* 🖼️ **Pemahaman Gambar** - Percakapan multimodal dengan dukungan input gambar
* 📝 **Manajemen Konteks** - Mengelola riwayat dan konteks percakapan secara cerdas
* 🎨 **Prompt Kustom** - Buat dan kelola template prompt
* 📊 **Ekspor Percakapan** - Ekspor catatan percakapan ke Markdown dan format lain
* 🔄 **Perbandingan Model** - Gunakan beberapa model sekaligus dan bandingkan output
## Dukungan & Bantuan
Jika Anda mengalami masalah:
* 📚 [Dokumentasi GccAi](https://gccai.heqingsong.uk)
* 💬 [Discord Community](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 mulai perjalanan AI Anda!
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.