Tutorial Integrasi API Relay RikkaHub: Konfigurasi Klien Obrolan AI Android

I. Apa itu RikkaHub

RikkaHub adalah klien obrolan AI Android sumber terbuka yang mendukung integrasi dengan berbagai saluran model seperti Anthropic (Claude), OpenAI (GPT), dan Google (Gemini). Dengan mengarahkan Provider-nya ke gateway relay dan memasukkan kunci sk-, Anda dapat memanggil berbagai seri model menggunakan saldo platform, dengan penagihan berdasarkan token.

II. Persiapan

1. Masuk ke konsol API, buat kunci sk-xxxxxx di bagian "API Key" (hanya akan ditampilkan sekali, harap simpan).
2. Konfirmasi slug model yang ingin digunakan (misalnya gemini-3.7-flash, claude-sonnet-5, gpt-5.5). Anda dapat melihatnya di sudut kanan atas halaman "Token" di konsol pada bagian "Model ID".
3. Konfirmasi alamat gateway: https://www.relay-api.com.

III. Konfigurasi di RikkaHub

Buka RikkaHub → "Settings" (Pengaturan) → "Provider" → klik "+" di sudut kanan atas untuk menambah baru, pilih tipe Provider sesuai dengan model yang ingin digunakan:

① Memanggil Gemini (Tipe Google, direkomendasikan)

Tipe Provider : Google / Gemini
Base URL      : https://www.relay-api.com/v1beta
API Key       : sk-kunci_anda
Model ID      : gemini-3.7-flash

Base URL harus menyertakan /v1beta. RikkaHub akan secara otomatis menyambungkan /models/{model}:generateContent di belakang Base URL. Jika /v1beta terlewat, permintaan akan diarahkan ke /models/... sehingga menghasilkan kesalahan 404 (halaman tidak ditemukan).

② Memanggil Claude (Tipe Anthropic)

Tipe Provider : Anthropic / Claude
Base URL      : https://www.relay-api.com
API Key       : sk-kunci_anda
Model ID      : claude-sonnet-5

Untuk tipe Anthropic, jangan tambahkan /v1 lagi di Base URL. Klien akan menambahkan sendiri /v1/messages. Jika ditulis ganda, hasilnya akan menjadi /v1/v1/messages.

③ Memanggil GPT (Tipe Kompatibel OpenAI)

Tipe Provider : OpenAI Compatible
Base URL      : https://www.relay-api.com/v1
API Key       : sk-kunci_anda
Model ID      : gpt-5.5

IV. Tabel Alamat Antarmuka

Grup Model	Tipe Provider	Base URL	Protokol
Gemini	Google / Gemini	https://www.relay-api.com/v1beta	Google generateContent
Claude	Anthropic	https://www.relay-api.com	Anthropic Messages
GPT	OpenAI Compatible	https://www.relay-api.com/v1	OpenAI Chat Completions

V. Poin Penting: Model Terisolasi per Grup, Tidak Dapat Lintas Grup

Tiga protokol di situs ini adalah entri asli yang berdiri sendiri, model terisolasi berdasarkan grup:

• Model dalam grup Gemini (gemini-3.7-flash, dll.) hanya bisa menggunakan tipe Google / Gemini + /v1beta.
• Jika memasukkan nama model Gemini ke dalam tipe Anthropic, akan muncul pesan 400 Model Claude tidak diaktifkan atau tidak ada: gemini-xxx.
• Jika memasukkan nama model Gemini ke dalam tipe OpenAI, akan muncul pesan 400 Model OpenAI tidak diaktifkan atau tidak ada: gemini-xxx.

Jadi, "Model ID" dan "Tipe Provider" harus cocok: Gunakan tipe Provider yang sesuai dengan grup model yang dipilih.

VI. Pemecahan Masalah Umum

Gejala	Penyebab & Solusi
Menghasilkan 404 (web/HTML)	Base URL melewatkan akhiran versi (misalnya Gemini kurang /v1beta), permintaan diarahkan ke jalur yang tidak ada. Tambahkan /v1beta atau /v1.
Jalur menjadi /v1beta/v1beta/ atau /v1/v1/	Versi ditulis dua kali di Base URL. Cukup tulis sekali saja di Base URL.
400 Model Claude/OpenAI tidak diaktifkan atau tidak ada: gemini-xxx	Grup model tidak cocok dengan tipe Provider—model Gemini dimasukkan ke tipe Claude/OpenAI. Ganti ke tipe Google / Gemini.
401 / 403	Kunci tidak valid, tidak diaktifkan, saldo tidak cukup, atau token tidak memiliki izin untuk rute/model tersebut. Periksa kunci dan saldo akun.
400 Request contains an invalid argument	Validasi upstream pada parameter tertentu (seperti ukuran level berpikir, tools); terkadang disebabkan oleh fluktuasi jangka pendek di upstream, cukup coba lagi.
Gagal mengambil daftar model	Beberapa klien sangat ketat dalam memproses daftar model yang dikembalikan oleh relay, coba ganti dengan "Mengisi Model ID secara manual".

VII. Saran Keamanan

• Jangan menulis kunci ke repositori publik atau tangkapan layar, disarankan menggunakan variabel lingkungan atau disimpan dengan aman secara lokal.
• Buat kunci terpisah untuk setiap perangkat atau alat guna memudahkan statistik penggunaan dan penonaktifan kapan saja.