Catatan Penulis: RikkaHub adalah klien Android yang mendukung berbagai Model Bahasa Besar. Artikel ini menggunakan APIYI sebagai contoh untuk menjelaskan langkah-langkah lengkap menghubungkan ke layanan proksi API pihak ketiga, dengan fokus pada perbedaan antara tipe saluran /v1 dan /v1beta serta kesalahan umum yang sering terjadi.
Menggunakan Model Bahasa Besar AI di ponsel kini membuat Anda tidak perlu lagi berpindah-pindah aplikasi antara ChatGPT, Gemini, dan Claude. RikkaHub adalah klien Model Bahasa Besar Android asli yang mendukung akses ke semua model utama melalui layanan proksi API pihak ketiga. Namun, banyak pengguna mengalami kendala saat konfigurasi: Kunci API yang sama bisa digunakan untuk semua model di Cherry Studio di komputer, tetapi di RikkaHub hanya model Google yang berfungsi, sementara GPT dan Claude tidak.
Masalahnya terletak pada tipe saluran—perbedaan antara /v1 dan /v1beta. Artikel ini menggunakan APIYI sebagai contoh untuk menjelaskan detail konfigurasi ini secara tuntas.
Nilai Utama: Setelah membaca artikel ini, Anda akan belajar cara mengonfigurasi layanan proksi APIYI dengan benar di RikkaHub, memahami perbedaan antara /v1 dan /v1beta, serta menggunakan satu aplikasi untuk memanggil semua model Claude, GPT, dan Gemini.
Poin Utama Menghubungkan RikkaHub ke APIYI
| Poin | Penjelasan | Kepentingan |
|---|---|---|
| Pemilihan Tipe Saluran | /v1 untuk semua model, /v1beta hanya untuk Gemini | Paling krusial |
| Base URL | https://vip.apiyi.com/v1 |
Perhatikan jalur akhir |
| Kunci API | Dapatkan dari platform APIYI | Satu kunci untuk semua model |
| Pemilihan Model | Masukkan nama model secara manual atau pilih dari daftar | Konfigurasi sesuai kebutuhan |
| Metode Konfigurasi | Buat Penyedia (Provider) terpisah untuk setiap tipe saluran | Praktik terbaik |
Apa itu RikkaHub?
RikkaHub adalah klien obrolan Model Bahasa Besar Android sumber terbuka yang dikembangkan dengan Kotlin + Jetpack Compose dan menggunakan bahasa desain Material You. Fitur terbesarnya adalah mendukung akses ke beberapa penyedia layanan AI dalam satu aplikasi, serta bebas beralih antar model saat berdialog.
| Informasi Dasar | Detail |
|---|---|
| Alamat Sumber Terbuka | github.com/rikkahub/rikkahub |
| Versi Terbaru | v2.1.7 (28/3/2026) |
| Platform yang Didukung | Android + Web |
| API yang Didukung | Kompatibel dengan OpenAI, asli Google Gemini, kompatibel dengan Anthropic |
| Fitur Utama | Beralih antar model, input multimodal, integrasi pencarian, dukungan MCP |
| Metode Instalasi | Google Play / Rilis GitHub / Unduhan situs resmi |
Fitur unggulan RikkaHub meliputi:
- Input Multimodal: Mendukung file gambar, PDF, dan DOCX
- Cabang Pesan: Menjelajahi arah jawaban yang berbeda dalam dialog
- Integrasi Pencarian: Mesin pencari bawaan seperti Exa, Tavily, Brave, dll.
- Dukungan MCP: Kompatibel dengan Model Context Protocol
- Rendering Markdown: Penyorotan kode, rumus LaTeX, diagram Mermaid
- Impor Kartu Karakter: Kompatibel dengan kartu karakter SillyTavern
Tutorial Lengkap Konfigurasi APIYI di RikkaHub
Langkah 1: Dapatkan Kunci API APIYI
Pertama, dapatkan Kunci API Anda di platform APIYI:
- Kunjungi APIYI di apiyi.com untuk mendaftar akun.
- Masuk ke dasbor, lalu buat Kunci API baru.
- Salin dan simpan kunci tersebut (formatnya mirip dengan
sk-xxxxxxxx).
Langkah 2: Tambahkan Provider di RikkaHub
Buka RikkaHub → Pengaturan → AI Provider → Tambah Provider baru:
Konfigurasi Saluran Kompatibel OpenAI (Direkomendasikan untuk semua model):
| Item Konfigurasi | Isi | Penjelasan |
|---|---|---|
| Tipe Provider | OpenAI Compatible | Pilih kompatibel dengan OpenAI |
| Base URL | https://vip.apiyi.com/v1 |
Pastikan diakhiri dengan /v1 |
| Kunci API | Kunci APIYI Anda | sk-xxxxxxxx |
| Nama Model | Isi sesuai kebutuhan | Contoh: claude-sonnet-4-20250514 |
Langkah 3: Pilih Model dan Mulai Percakapan
Setelah konfigurasi selesai, pilih model yang sesuai di antarmuka percakapan untuk mulai menggunakannya. Melalui antarmuka terpadu APIYI, Anda dapat memanggil model berikut di RikkaHub:
- Seri Claude: claude-sonnet-4, claude-opus-4, dll.
- Seri GPT: gpt-5.4, gpt-5.4-mini, dll.
- Seri Gemini: gemini-2.5-pro, gemini-2.5-flash, dll.
- Model Open Source: Llama 4, DeepSeek, dll.
🎯 Mulai Cepat: Setelah mendapatkan Kunci API dari APIYI apiyi.com, cukup tambahkan satu Provider di RikkaHub, dan Anda bisa bebas beralih antar semua model AI utama langsung dari ponsel.
Penjelasan Mendalam Saluran /v1 dan /v1beta: Perbedaan Konfigurasi Paling Krusial
Mengapa Kunci yang Sama Tidak Bisa Digunakan untuk Beberapa Model di RikkaHub
Ini adalah masalah yang paling sering ditemui pengguna RikkaHub:
"Kenapa token dan API yang sama bisa digunakan di Cherry Studio di komputer, tapi di RikkaHub Android hanya bisa pakai model Google, sedangkan GPT dan Claude tidak bisa?"
Penyebab Utama: RikkaHub memiliki dua tipe saluran. Jika salah pilih, beberapa model tidak akan bisa digunakan.
Perbedaan Inti antara /v1 dan /v1beta
| Fitur | /v1 (Kompatibel OpenAI) | /v1beta (Native Gemini) |
|---|---|---|
| Model Kompatibel | Claude + GPT + Gemini + Open Source | Hanya seri Gemini |
| Format API | Format OpenAI Chat Completions | Format asli Google Gemini |
| Contoh Base URL | https://vip.apiyi.com/v1 |
https://vip.apiyi.com/v1beta |
| Skenario Penggunaan | Umum, direkomendasikan sebagai pilihan utama | Saat butuh fitur khusus Gemini |
| Kompatibilitas Model Google | Baik | Terbaik |
Keunggulan dan Keterbatasan /v1beta
/v1beta adalah format API asli Google Gemini. Saat Anda memilih jalur /v1beta, RikkaHub akan menggunakan format permintaan asli Gemini (bukan format kompatibel OpenAI) untuk berkomunikasi dengan server.
Keunggulan:
- Kompatibilitas terbaik untuk model Gemini
- Mendukung fitur khusus Gemini (seperti Grounding, Pengaturan Keamanan)
- Format respons lebih asli, tanpa konversi format
Keterbatasan:
- Hanya bisa digunakan untuk model seri Gemini
- Model non-Google seperti Claude, GPT, dll., tidak akan berfungsi sama sekali
- Karena format permintaan berbeda, permintaan yang dikirim ke Claude/GPT akan langsung error
Solusi Konfigurasi yang Benar
Opsi A: Hanya gunakan /v1 (Direkomendasikan untuk sebagian besar pengguna)
Jika Anda terutama menggunakan campuran model Claude, GPT, dan Gemini, cukup buat satu Provider yang kompatibel dengan OpenAI:
Tipe Provider: OpenAI Compatible
Base URL: https://vip.apiyi.com/v1
Kunci API: sk-your-apiyi-key
Konfigurasi ini dapat memanggil semua model di APIYI, termasuk Gemini.
Opsi B: Provider ganda /v1 + /v1beta (Untuk pengguna tingkat lanjut)
Jika Anda ingin mendapatkan kompatibilitas terbaik untuk model Gemini, Anda dapat membuat dua Provider:
| Provider | Tipe | Base URL | Kegunaan |
|---|---|---|---|
| Provider 1 | OpenAI Compatible | https://vip.apiyi.com/v1 |
Claude / GPT / Model Open Source |
| Provider 2 | Gemini | https://vip.apiyi.com/v1beta |
Seri Gemini (kompatibilitas terbaik) |
Kedua Provider menggunakan Kunci APIYI yang sama. Saat melakukan percakapan, sistem akan secara otomatis memilih Provider yang sesuai dengan model yang digunakan.
💡 Tips Menghindari Masalah: Jika Anda hanya membuat Provider tipe
/v1beta, maka hanya model Gemini yang bisa digunakan. Inilah alasan mengapa banyak pengguna melaporkan "hanya bisa menggunakan model Google". Solusinya adalah membuat satu Provider tipe/v1lagi, atau cukup gunakan/v1sebagai satu-satunya Provider.
Contoh Konfigurasi Model Umum RikkaHub
Tabel Konfigurasi Model Populer RikkaHub
Berikut adalah konfigurasi model yang umum digunakan di RikkaHub melalui APIYI:
| Model | ID Model | Tipe Saluran | Penggunaan yang Disarankan |
|---|---|---|---|
| Claude Sonnet 4 | claude-sonnet-4-20250514 | /v1 | Percakapan harian, analisis |
| Claude Opus 4 | claude-opus-4-20250514 | /v1 | Penalaran kompleks |
| GPT-5.4 | gpt-5.4 | /v1 | Flagship umum |
| GPT-5.4 Mini | gpt-5.4-mini | /v1 | Ringan dan efisien |
| Gemini 2.5 Pro | gemini-2.5-pro | /v1 atau /v1beta | Jendela konteks panjang |
| Gemini 2.5 Flash | gemini-2.5-flash | /v1 atau /v1beta | Respons cepat |
| DeepSeek V3 | deepseek-chat | /v1 | Penalaran hemat biaya |
| Llama 4 Maverick | meta-llama/llama-4-maverick | /v1 | Open-source terbaik |
Tips Konfigurasi Lanjutan RikkaHub
Header HTTP Kustom: RikkaHub mendukung header permintaan kustom jika Anda perlu meneruskan parameter tambahan:
Headers:
X-Custom-Header: nilai-anda
Impor/Ekspor Kode QR: Anda dapat membuat kode QR dari konfigurasi Provider, memudahkan untuk berbagi dengan teman atau menyinkronkan antar perangkat.
Variabel Petunjuk: Mendukung penggunaan variabel dalam petunjuk sistem seperti {model} (nama model saat ini), {timestamp} (stempel waktu).
🚀 Tips Efisiensi: Melalui antarmuka terpadu APIYI apiyi.com, Anda hanya memerlukan satu kunci API untuk beralih secara bebas antara Claude, GPT, Gemini, DeepSeek, dan semua model utama lainnya di RikkaHub. Dikombinasikan dengan fitur percabangan percakapan RikkaHub, Anda dapat dengan cepat membandingkan kualitas jawaban dari model yang berbeda.
Perbandingan RikkaHub dengan Klien AI Android Lainnya
| Dimensi Perbandingan | RikkaHub | Aplikasi ChatGPT | Aplikasi Gemini | Aplikasi Claude |
|---|---|---|---|---|
| Dukungan Multi-Model | Semua model | Hanya GPT | Hanya Gemini | Hanya Claude |
| API Kustom | Mendukung | Tidak mendukung | Tidak mendukung | Tidak mendukung |
| Layanan Proksi Pihak Ketiga | Mendukung | Tidak mendukung | Tidak mendukung | Tidak mendukung |
| Open-source | Ya | Tidak | Tidak | Tidak |
| Dukungan MCP | Ya | Tidak | Tidak | Tidak |
| Integrasi Pencarian | Multi-mesin | ChatGPT Search | Tidak ada | |
| Harga | Gratis | Berlangganan | Berlangganan | Berlangganan |
Keunggulan pembeda terbesar RikkaHub adalah: Satu aplikasi untuk semua model AI. Dengan bantuan platform layanan proksi API seperti APIYI, Anda tidak perlu lagi membayar dan menginstal aplikasi secara terpisah untuk setiap penyedia layanan AI.
🎯 Saran Pemilihan: Jika Anda hanya menggunakan satu layanan AI (misalnya hanya ChatGPT), menggunakan aplikasi resmi akan lebih praktis. Namun, jika Anda seperti kebanyakan pengembang yang perlu beralih di antara berbagai model, RikkaHub + APIYI apiyi.com adalah solusi paling fleksibel di Android.
Pemecahan Masalah Umum Integrasi RikkaHub dengan APIYI
Kesalahan Umum dan Solusinya
| Gejala Masalah | Penyebab | Solusi |
|---|---|---|
| Hanya Gemini yang berfungsi, lainnya error | Tipe kanal dipilih /v1beta | Ubah ke /v1 atau buat Provider kompatibel OpenAI baru |
| Semua model error | Base URL salah diisi | Pastikan menggunakan https://vip.apiyi.com/v1 |
| Autentikasi gagal | Kunci API salah atau kedaluwarsa | Periksa status kunci di konsol APIYI |
| Model tidak ditemukan | ID model salah ketik | Lihat dokumentasi APIYI untuk memastikan ID model |
| Format respons tidak normal | Tipe kanal tidak cocok dengan model | Gunakan /v1beta untuk Gemini, dan /v1 untuk lainnya |
Pertanyaan yang Sering Diajukan (FAQ)
Q1: Mana yang harus saya pilih, /v1 atau /v1beta?
Dalam kebanyakan kasus, pilih /v1. /v1 adalah format yang kompatibel dengan OpenAI dan mendukung semua model (termasuk Gemini). /v1beta adalah format asli Gemini yang hanya mendukung model Gemini, namun memiliki kompatibilitas yang lebih baik. Jika Anda lebih sering menggunakan Claude dan GPT, pilih /v1. Jika Anda juga membutuhkan pengalaman terbaik dari Gemini, Anda bisa membuat dua Provider terpisah. Anda dapat mengonfigurasi kedua kanal tersebut menggunakan kunci yang sama dari platform APIYI (apiyi.com).
Q2: Bagaimana jika bisa digunakan di Cherry Studio tetapi tidak di RikkaHub?
Penyebab paling umum adalah kesalahan konfigurasi tipe kanal. Cherry Studio secara default menggunakan format kompatibel OpenAI (/v1). Jika Anda memilih tipe Gemini (/v1beta) di RikkaHub, model selain Google tidak akan bisa digunakan. Solusinya: Buat Provider baru dengan tipe OpenAI Compatible, lalu isi Base URL dengan https://vip.apiyi.com/v1.
Q3: Apakah RikkaHub gratis?
Aplikasi RikkaHub sendiri gratis dan open-source. Namun, pemanggilan Model Bahasa Besar memerlukan biaya API. Anda bisa mendapatkan kunci API melalui platform APIYI (apiyi.com) dan membayar sesuai penggunaan nyata, tanpa biaya bulanan atau langganan. Dibandingkan harus berlangganan ChatGPT Plus ($20/bulan), Claude Pro ($20/bulan), dan Gemini Advanced ($19,99/bulan) secara terpisah, model bayar per penggunaan melalui APIYI + RikkaHub biasanya jauh lebih hemat.
Ringkasan
Poin utama dalam menghubungkan RikkaHub ke layanan proksi API pihak ketiga:
- Tipe saluran adalah kunci:
/v1kompatibel dengan semua model (Claude/GPT/Gemini/Open Source), sedangkan/v1betahanya kompatibel dengan Gemini namun memiliki kompatibilitas yang lebih baik untuk model Google. - Rekomendasi skema dua Provider: Gunakan
/v1sebagai saluran umum +/v1betasebagai saluran khusus Gemini, cukup dengan satu kunci API APIYI yang sama. - Satu aplikasi untuk segalanya: RikkaHub + APIYI apiyi.com, memungkinkan Anda beralih antar model seperti Claude, GPT, dan Gemini dengan bebas di Android.
Tidak perlu lagi berpindah-pindah antar tiga atau empat aplikasi AI. Kami merekomendasikan untuk mendapatkan kunci API melalui APIYI apiyi.com. Satu kunci mencakup semua model utama, dikombinasikan dengan RikkaHub untuk menjadikan ponsel Anda asisten AI serba bisa.
📚 Referensi
-
Repositori GitHub RikkaHub: Kode sumber terbuka dan unduhan versi terbaru
- Tautan:
github.com/rikkahub/rikkahub - Keterangan: Berisi kode sumber lengkap, unduhan rilis, dan penjelasan fitur.
- Tautan:
-
Dokumentasi Resmi RikkaHub: Panduan konfigurasi dan penggunaan Provider
- Tautan:
docs.rikka-ai.com - Keterangan: Berisi metode konfigurasi mendetail untuk berbagai jenis Provider.
- Tautan:
-
Pusat Dokumentasi APIYI: Cara mendapatkan kunci API dan daftar model
- Tautan:
docs.apiyi.com - Keterangan: Berisi ID semua model yang didukung, harga, dan contoh pemanggilan model.
- Tautan:
Penulis: Tim Teknis APIYI
Diskusi Teknis: Silakan bagikan pengalaman konfigurasi RikkaHub Anda di kolom komentar. Untuk informasi lebih lanjut mengenai akses model AI, kunjungi pusat dokumentasi APIYI di docs.apiyi.com.
