Gemini API dalam format kompatibel OpenAI
Gemini API bisa dipanggil dengan SDK OpenAI: isi base_url dengan https://api.relayswitch.io/v1, pakai API key RelaySwitch, dan tulis id Gemini di model. Ada 21 model Gemini dengan harga yang dibaca langsung dari katalog, dan Anda tidak memerlukan akun Google.
01Bedanya dengan Gemini API langsung dari Google
Memakai Gemini API secara langsung berarti punya akun Google, membuat key di Google AI Studio, lalu membayar menurut cara penagihan Google. Di sini bagian itu diganti: Anda mengisi saldo di RelaySwitch, memakai key RelaySwitch, dan request dikirim ke gateway yang meneruskannya ke Gemini. Bagi kode Anda, yang berubah hanya alamat dan key; id modelnya tetap id Gemini.
Gemini punya format request sendiri (generateContent), tetapi sebagian besar tool dan kode yang sudah ada ditulis untuk OpenAI Chat Completions. Google sendiri menyediakan lapisan kompatibel OpenAI dan mencatat di dokumentasinya bahwa dukungan itu masih beta. Pendekatan di sini sama: setiap id Gemini di tabel harga bisa dipanggil dalam format OpenAI, sehingga memindahkan kode OpenAI ke Gemini cukup dengan mengganti field model.
02Request pertama dengan curl
Pastikan dulu key dan alamatnya benar dengan curl. Key dikirim di header Authorization: Bearer, dan yang diganti dari contoh OpenAI biasa hanya Base URL, key, dan model.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gemini-3.1-pro-preview", "messages": [{"role": "user", "content": "Reply with ok"}]}'03SDK OpenAI untuk Python
Base URL ditulis dengan /v1, lalu SDK menambahkan /chat/completions sendiri. Untuk streaming, isi stream dengan true; responsnya berupa server-sent events dengan format yang sama seperti OpenAI. Jumlah token di usage sama dengan yang tercatat di struk.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="gemini-3.1-pro-preview", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)04Pindah dari endpoint kompatibel OpenAI milik Google
Kode yang ditulis mengikuti dokumentasi kompatibel OpenAI dari Google sudah memakai SDK OpenAI, jadi isi request tidak perlu diubah. Field khusus Gemini yang di dokumentasi Google dikirim lewat extra_body tidak diuji satu per satu di halaman ini; jika Anda memakainya, uji dulu dengan satu request dan periksa apakah penagihan di struk sesuai harapan.
Hanya tiga hal yang berubah:
base_url: dari alamat di dokumentasi Google menjadi https://api.relayswitch.io/v1.api_key: dari key Google AI Studio menjadi key RelaySwitch yang berawalansk-relay-.model: cocokkan id-nya dengan tabel harga di halaman ini dan pakai yang tertulis saat itu; id yang salah dijawab 404model_not_found.
05Format native Gemini: generateContent
Program yang sudah ditulis dengan format request Google tidak perlu ditulis ulang, selama id Gemini yang dipakai melayani rute ini. Jalurnya /v1beta/models/{model}:generateContent, langsung di belakang https://api.relayswitch.io tanpa /v1. Key dikirim di header x-goog-api-key, bukan di URL: key yang ditaruh di query parameter ditolak gateway. Isi request dan respons memakai struktur Google, contents masuk dan candidates keluar.
Pesan error mengikuti format masing-masing. Di format OpenAI, kodenya ada di error.code; di format native, bentuknya mengikuti Google, misalnya 401 dengan error.status berisi UNAUTHENTICATED saat key tidak dikirim. Kedua format memakai key, saldo, dan harga yang sama. Tabel kode error per status ada di halaman OpenAI API dan berlaku penuh saat Gemini dipanggil dalam format OpenAI.
06Harga model Gemini terkini
Dalam USD per satu juta token, dibaca dari katalog saat halaman dirender. Penagihan memakai tiga harga: input, cached input, dan output, dan harga di tabel adalah harga yang dipotong dari saldo.
Gemini sering dipakai untuk membaca materi panjang: kontrak utuh, satu repositori kode, atau transkrip rapat. Biaya request semacam itu hampir seluruhnya ada di input, jadi saat memilih model lihat dulu harga input dan panjang konteks, baru harga output. Jika materi yang sama ditanyai berulang kali, bagian yang berulang mengenai cache mulai request kedua dan ditagih dengan harga cached input; struk mencatat token itu secara terpisah.
| Model | Pengembang | Input | Output | Konteks |
|---|---|---|---|---|
| Gemini 4 Argongemini-4-argon | $0.60≈ Rp 11.166 | $3.00≈ Rp 55.830 | 1,048,576 | |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925≈ Rp 9.165 | $2.25≈ Rp 41.872 | 1,048,576 | |
| Gemini 3.7 Flashgemini-3.7-flash | $0.4925≈ Rp 9.165 | $2.25≈ Rp 41.873 | 1,048,576 | |
| Gemini 3.5 Flash Litegemini-3.5-flash-lite | $0.225≈ Rp 4.187 | $1.875≈ Rp 34.894 | 1,048,576 | |
| Gemini 3.6 Flashgemini-3.6-flash | $0.4925≈ Rp 9.165 | $2.25≈ Rp 41.873 | 1,048,576 | |
| Gemini 3.5 Flashgemini-3.5-flash | $1.50≈ Rp 27.915 | $9.00≈ Rp 167.489 | 1,048,576 | |
| Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview | $0.1875≈ Rp 3.489 | $1.125≈ Rp 20.936 | 1,048,576 | |
| Gemini 3.1 Pro Previewgemini-3.1-pro-preview | $1.20≈ Rp 22.332 | $7.20≈ Rp 133.991 | 1,048,576 | |
| Gemini 3.1 PRO Preview LOWgemini-3.1-pro-preview-low | $5.00≈ Rp 93.050 | $22.50≈ Rp 418.723 | 1,048,576 | |
| Gemini 3 Flash Previewgemini-3-flash-preview | $0.375≈ Rp 6.979 | $2.25≈ Rp 41.872 | 1,048,576 | |
| Gemini 2.5 Flashgemini-2.5-flash | $0.30≈ Rp 5.583 | $2.50≈ Rp 46.525 | 1,048,576 | |
| Gemini 2.5 Progemini-2.5-pro | $0.9375≈ Rp 17.447 | $7.50≈ Rp 139.574 | 1,048,576 | |
| Gemini 2.5 Flash Litegemini-2.5-flash-lite | $0.075≈ Rp 1.396 | $0.30≈ Rp 5.583 | ||
| Gemini 3 Pro Previewgemini-3-pro-preview | $5.00≈ Rp 93.050 | $22.50≈ Rp 418.723 | ||
| Gemini 3.1 Flash Litegemini-3.1-flash-lite | $0.15≈ Rp 2.791 | $0.90≈ Rp 16.749 | ||
| Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtools | $4.80≈ Rp 89.328 | $28.80≈ Rp 535.965 | 1,048,576 | |
| Gemini 4 Carbongemini-4-carbon | $2.3529≈ Rp 43.788 | $11.7647≈ Rp 218.940 | ||
| Gemini 4 Hydrogengemini-4-hydrogen | $0.5882≈ Rp 10.947 | $2.9412≈ Rp 54.735 | ||
| Gemini Flash Latestgemini-flash-latest | $1.80≈ Rp 33.498 | $9.00≈ Rp 167.489 | 1,048,576 | |
| Gemini Flash Lite Latestgemini-flash-lite-latest | $0.72≈ Rp 13.399 | $6.00≈ Rp 111.659 | 1,048,576 | |
| Gemini PRO Latestgemini-pro-latest | $4.80≈ Rp 89.328 | $28.80≈ Rp 535.965 | 1,048,576 |
USD per satu juta token · ≈ adalah harga acuan dalam rupiah menurut kurs Bank Sentral Eropa tanggal 2026-11-13; tagihan tetap dalam dolar AS
07Memilih model dan persiapan production
Nama model yang memuat kata preview adalah versi pratinjau yang nantinya diganti Google dengan nama resmi, jadi id yang ditulis di kode harus mengikuti yang tertera di tabel saat itu. Memilih model tidak perlu menebak: semua id Gemini ada di key yang sama, jadi kirim prompt yang sama ke masing-masing, lalu bandingkan jawaban dan biaya di struknya. Membandingkan dengan GPT atau Claude juga hanya soal mengganti model.
Untuk production, buat key terpisah, beri anggaran dolar dan batas belanja harian, lalu batasi dengan allowlist model ke id Gemini yang Anda pilih. Program pembaca dokumen panjang paling memerlukan batas ini, karena satu request yang keliru mengirim seluruh direktori bisa memuat ratusan ribu token input. Untuk request yang gagal, baca header retry-after sebelum mencoba lagi. Cara membuat key dan memasang batasnya ada di halaman Claude API key.
Pertanyaan umum
- Bagaimana cara memakai Gemini API di sini?
- Ubah dua hal di kode: base_url menjadi https://api.relayswitch.io/v1 dan api_key menjadi key RelaySwitch yang berawalan sk-relay-. Lalu tulis id Gemini di model dan panggil lewat Chat Completions dengan SDK OpenAI. Akun dibuka dengan email, dan saldo diisi dengan kartu atau kripto mulai $10.
- Apakah perlu akun Google atau API key dari Google AI Studio?
- Tidak. Gemini API milik Google memerlukan akun Google untuk membuat key di AI Studio. Di sini akun dibuka di RelaySwitch dengan satu email, key dibuat di console RelaySwitch, dan key yang sama bisa memanggil model lain di katalog.
- Pakai SDK OpenAI atau format native Gemini?
- Untuk program baru, pakai SDK OpenAI: cukup ganti base_url, dan berpindah ke model pengembang lain hanya mengubah field model. Program yang sudah ditulis dengan generateContent bisa mengirim request ke rute /v1beta/models/{model}:generateContent dengan key di header x-goog-api-key. Kedua format memakai key, saldo, dan harga yang sama.
- Apakah Gemini API gratis?
- Gemini API milik Google punya free tier dengan batas laju untuk sebagian model; model mana yang termasuk mengikuti halaman harga Google. Di sini tidak ada free tier: setiap request dipotong per token dari saldo prabayar, top-up terkecil $10, dan saldo tidak kedaluwarsa.
- Bagaimana harga Gemini API di sini dibanding harga resmi Google?
- Harga tiap model dibaca dari katalog saat halaman dirender, dan harga di tabel adalah harga yang dipotong dari saldo. Harga resmi yang dipublikasikan Google ditampilkan berdampingan di halaman tiap model, jadi keduanya bisa dibandingkan langsung.
- Bagaimana memastikan yang menjawab memang Gemini?
- Setiap model menerima prompt uji yang sama sekali sehari dan jawabannya dibandingkan dengan hasil sebelumnya; hasilnya terbuka di https://api.relayswitch.io/v1/proof tanpa API key. Setiap request juga punya struk bertanda tangan (GET https://api.relayswitch.io/v1/requests/:id/receipt) yang mencatat id model, token yang ditagih, dan biayanya.
Ganti base_url, lalu ganti model
Base URL https://api.relayswitch.io/v1, model Gemini ditagih per token sesuai harga katalog, dengan cek harian yang terbuka untuk publik.