Gatera AI kompatibel dengan format OpenAI dan Anthropic. Cukup ganti base URL dan API key di aplikasi yang sudah ada. Panduan di bawah berurutan dari akun baru sampai permintaan pertama.
Buat akun dan verifikasi email
Isi saldo
Buat API key
Kirim permintaan pertama
Saldo dipotong sesuai pemakaian token tiap permintaan. Tidak ada biaya langganan dan saldo tidak kedaluwarsa.
Pilih nominal
Bayar lewat QRIS
Selesaikan pembayaran
Cek saldo
Saldo menipis? Dashboard menampilkan peringatan saat saldo di bawah Rp5.000 supaya API Anda tidak berhenti mendadak.
Buat kunci
Atur batas pengeluaran (opsional)
Batasi IP (opsional)
Simpan sebagai variabel lingkungan
GATERA_API_KEY atau file .env, jangan tulis langsung di kode.Cabut kalau bocor
Jangan pasang API key di kode frontend (browser atau aplikasi yang didistribusikan) dan jangan commit ke repo publik. Panggil Gatera dari server Anda.
https://api.gatera.web.id/v1Autentikasi lewat header Authorization: Bearer KUNCI atau x-api-key: KUNCI.
Endpoint POST /v1/chat/completions, mendukung streaming.
curl https://api.gatera.web.id/v1/chat/completions \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-mini",
"messages": [{ "role": "user", "content": "Halo" }]
}'Tambahkan stream=True (atau "stream": true di JSON) untuk menerima jawaban potong demi potong.
from openai import OpenAI
client = OpenAI(base_url="https://api.gatera.web.id/v1", api_key="API_KEY_ANDA")
stream = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "Ceritakan satu fakta unik."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Endpoint POST /v1/messages. Untuk SDK Anthropic, isi base URL tanpa /v1.
curl https://api.gatera.web.id/v1/messages \
-H "x-api-key: API_KEY_ANDA" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "NAMA_MODEL",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "Halo" }]
}'Tambahkan "stream": true pada /v1/messages. Hasil datang sebagai server-sent events, sama seperti API Anthropic.
curl https://api.gatera.web.id/v1/messages \
-H "x-api-key: API_KEY_ANDA" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-N \
-d '{
"model": "NAMA_MODEL",
"max_tokens": 1024,
"stream": true,
"messages": [{ "role": "user", "content": "Ceritakan satu fakta unik." }]
}'Format OpenAI di /v1/chat/completions. Pilih model yang mendukung tool. Di /v1/messages hanya tool buatan Anda sendiri yang diteruskan; tool bawaan penyedia seperti web search tidak didukung karena punya biaya terpisah.
curl https://api.gatera.web.id/v1/chat/completions \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "NAMA_MODEL",
"messages": [{ "role": "user", "content": "Cuaca di Surabaya?" }],
"tools": [{
"type": "function",
"function": {
"name": "cek_cuaca",
"description": "Ambil cuaca terkini untuk sebuah kota",
"parameters": {
"type": "object",
"properties": { "kota": { "type": "string" } },
"required": ["kota"]
}
}
}]
}'Hanya untuk model berlabel vision di menu Model. Kirim gambar sebagai image_url (alamat web atau data URL base64). Ukuran seluruh permintaan maksimum 5 MB.
{
"model": "NAMA_MODEL_VISION",
"messages": [{
"role": "user",
"content": [
{ "type": "text", "text": "Apa isi gambar ini?" },
{ "type": "image_url", "image_url": { "url": "data:image/png;base64,AAAA..." } }
]
}]
}POST /v1/images/generations. Parameter: prompt (wajib, maks. 4.000 karakter), model, n (1 sampai 4), size (1024x1024, 1024x1536, atau 1536x1024), quality (low, medium, high), dan output_format (png, jpeg, webp). Hasilnya base64 di data[].b64_json; tidak ada URL hosting, jadi simpan sendiri.
curl https://api.gatera.web.id/v1/images/generations \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Kucing oren memakai helm di atas motor, gaya kartun",
"size": "1024x1024",
"quality": "medium"
}'curl https://api.gatera.web.id/v1/models -H "Authorization: Bearer API_KEY_ANDA"Hanya model yang aktif dan diizinkan untuk API key tersebut yang muncul. Gunakan nilai id apa adanya sebagai nama model.
Retry-After (detik)./v1/chat/completions. Model yang menjawab tertulis di field model dan header X-Gatera-Fallback-From. Matikan per permintaan dengan header X-Gatera-Fallback: off.Kode Anda tidak perlu diubah selain satu nilai: isi model dengan nama model lain. Gatera meneruskannya ke penyedia yang sesuai (OpenAI, DeepSeek, Claude, Kimi, Gemini, atau Grok).
Lihat model yang tersedia
GET /v1/models.Salin nama model persis
Bandingkan sebelum memilih
curl https://api.gatera.web.id/v1/models \
-H "Authorization: Bearer API_KEY_ANDA"Gatera cocok dengan alat yang mendukung endpoint OpenAI, Responses, atau Anthropic. Semuanya memakai API key Gatera dan nama model persis seperti di menu Model. Ganti NAMA_MODEL di contoh dengan nama itu.
Malas mengganti placeholder? Buka Ringkasan dan pakai kartu Hubungkan alat: pilih alat dan model, lalu salin konfigurasi yang sudah berisi base URL, API key, dan model.
https://api.gatera.web.idhttps://api.gatera.web.id/v1https://api.gatera.web.id/v1Claude Code memakai format Anthropic, jadi isi base URL tanpa /v1. Model non-Claude (DeepSeek, OpenAI, Grok, dan lainnya) tetap bisa dipakai karena Gatera menerjemahkan formatnya.
export ANTHROPIC_BASE_URL=https://api.gatera.web.id
export ANTHROPIC_AUTH_TOKEN=API_KEY_ANDA
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL=NAMA_MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=NAMA_MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=NAMA_MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=NAMA_MODEL_YANG_MURAH
claudeAgar permanen, taruh di blok env pada ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.gatera.web.id",
"ANTHROPIC_AUTH_TOKEN": "API_KEY_ANDA",
"ANTHROPIC_MODEL": "NAMA_MODEL",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "NAMA_MODEL",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "NAMA_MODEL",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "NAMA_MODEL_YANG_MURAH"
}
}Isi ketiga alias (opus, sonnet, haiku). Claude Code mengirim tugas latar ke alias haiku, dan bila namanya tidak ada di Gatera akan muncul error 404 di tengah sesi. Jalankan /status di dalam Claude Code untuk memastikan Base URL dan Auth token sudah benar. Variabel ANTHROPIC_API_KEY juga diterima, tapi kosongkan bila memakai ANTHROPIC_AUTH_TOKEN agar tidak bentrok. Jangan simpan API key di .claude/settings.json milik proyek yang masuk Git.
Simpan di ~/.codex/config.toml:
model_provider = "gatera"
model = "NAMA_MODEL"
[model_providers.gatera]
name = "Gatera AI"
base_url = "https://api.gatera.web.id/v1"
env_key = "GATERA_API_KEY"
wire_api = "responses"Lalu set variabel kunci dan jalankan Codex:
export GATERA_API_KEY=API_KEY_ANDA
codexHermes (Nous Research) memakai endpoint kustom yang kompatibel dengan OpenAI. Cara tercepat: jalankan hermes model, pilih Custom endpoint, lalu isi base URL, API key, dan nama model. Atau edit ~/.hermes/config.yaml:
model:
default: NAMA_MODEL
provider: custom
base_url: https://api.gatera.web.id/v1
api_key: API_KEY_ANDAprovider: custom wajib untuk endpoint di luar daftar bawaan Hermes. Isi base_url sampai /v1 saja, tanpa /chat/completions. Pilih model yang mendukung function calling karena Hermes memakai tool.
Tambahkan penyedia kustom di ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"gatera": {
"npm": "@ai-sdk/openai-compatible",
"name": "Gatera AI",
"options": {
"baseURL": "https://api.gatera.web.id/v1",
"apiKey": "{env:GATERA_API_KEY}"
},
"models": {
"NAMA_MODEL": {}
}
}
},
"model": "gatera/NAMA_MODEL"
}Set GATERA_API_KEY di terminal, jalankan opencode, lalu pilih model lewat /models. Base URL harus berakhir di /v1.
export OPENAI_API_BASE=https://api.gatera.web.id/v1
export OPENAI_API_KEY=API_KEY_ANDA
aider --model openai/NAMA_MODELAwalan openai/ memberi tahu Aider agar memakai endpoint kompatibel OpenAI.
Buka Settings, menu Models. Aktifkan override OpenAI Base URL ke https://api.gatera.web.id/v1, isi API key dengan kunci Gatera, lalu tambahkan nama model persis dari menu Model.
Di pengaturan penyedia, pilih OpenAI Compatible. Isi Base URL dengan https://api.gatera.web.id/v1, lalu API Key dan Model ID dengan nama model dari menu Model.
Tambahkan model di config.yaml Continue:
name: Gatera
version: 1.0.0
schema: v1
models:
- name: Gatera AI
provider: openai
model: NAMA_MODEL
apiBase: https://api.gatera.web.id/v1
apiKey: API_KEY_ANDABuka Admin Panel, Settings, Connections, bagian OpenAI API, lalu tambah koneksi baru dengan URL https://api.gatera.web.id/v1 dan API key Gatera. Untuk Docker, bisa lewat variabel lingkungan:
OPENAI_API_BASE_URL=https://api.gatera.web.id/v1
OPENAI_API_KEY=API_KEY_ANDATambahkan penyedia bertipe OpenAI-compatible (Custom). Isi API Host atau Base URL dengan https://api.gatera.web.id/v1, lalu API key dan nama model. Bila muncul error 404 karena aplikasi menambahkan /v1 sendiri, hapus /v1 dari alamat tadi.
Buat credential OpenAI API, isi API Key dengan kunci Gatera, dan ubah Base URL menjadi https://api.gatera.web.id/v1. Di node OpenAI, ketik nama model dari menu Model.
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="NAMA_MODEL",
base_url="https://api.gatera.web.id/v1",
api_key="API_KEY_ANDA",
)
print(llm.invoke("Halo").content)import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";
const gatera = createOpenAICompatible({
name: "gatera",
baseURL: "https://api.gatera.web.id/v1",
apiKey: process.env.GATERA_API_KEY,
});
const { text } = await generateText({
model: gatera("NAMA_MODEL"),
prompt: "Halo",
});
console.log(text);Sebelum menyambungkan, tes dulu dengan curl https://api.gatera.web.id/v1/models -H "Authorization: Bearer API_KEY_ANDA". Error 401 berarti kunci salah, 404 berarti nama model tidak dikenal, dan 402 berarti saldo habis. Rinciannya ada di bagian Kode error.
Body atau parameter tidak valid.
Periksa JSON-nya: field model dan messages harus ada, dan formatnya sesuai endpoint yang dipakai.
API key salah, dicabut, atau sudah kedaluwarsa.
Salin ulang kunci tanpa spasi, atau buat kunci baru di menu API Key.
Saldo tidak cukup. Isi saldo di menu Saldo.
Isi saldo lewat menu Saldo. Setelah saldo masuk, kirim ulang permintaannya.
API key ini dibatasi ke model tertentu dan model yang diminta tidak termasuk, atau permintaan datang dari IP yang tidak ada di daftar IP kunci.
Ganti ke model yang diizinkan, atau ubah batas model dan daftar IP kunci di menu API Key. Pesan galatnya menyebut IP yang ditolak.
Model tidak tersedia. Cek daftar di menu Model.
Samakan nama model persis dengan daftar di menu Model atau hasil GET /v1/models.
Permintaan terlalu besar (maksimum 5 MB, untuk pembuatan gambar 100 KB).
Kecilkan gambar lampiran atau pangkas riwayat percakapan, lalu kirim ulang.
Terlalu banyak permintaan, atau batas pengeluaran harian/bulanan API key tercapai.
Tunggu sebentar lalu coba lagi. Kalau karena batas pengeluaran, naikkan batas atau pakai kunci lain.
Penyedia model bermasalah. Coba lagi sebentar.
Ulangi permintaan beberapa saat lagi, atau coba model dari penyedia lain.
Tidak. Anda hanya membayar pemakaian token dari saldo rupiah.
Tidak. Saldo yang sudah masuk tidak punya masa berlaku. Aturan pengembalian dana ada di Kebijakan Refund.
Dari jumlah token masuk dan keluar dikalikan harga model, dalam rupiah per 1 juta token. Harga mengikuti kurs yang diperbarui otomatis, jadi angkanya bisa berubah.
Bisa. Ganti base URL dan API key, kode lainnya tetap sama.
Bisa. Panduan lengkapnya ada di bagian Hubungkan alat favorit: Claude Code lewat format Anthropic, Codex lewat Responses, dan Hermes, OpenCode, serta alat lain lewat format OpenAI.
Pakai menu Chat untuk mengobrol dengan model, Playground untuk mengatur parameter, atau Bandingkan untuk membandingkan beberapa model.
Segera cabut di menu API Key, buat kunci baru, lalu perbarui di aplikasi Anda. Cek menu Log untuk melihat apakah ada permintaan yang tidak dikenal.
Masih bingung? Hubungi kami lewat halaman Kontak.