Dokumentasi

Hubungkan workflow AI Anda.

Gunakan Gaionix AI Gateway dengan Claude Code atau aplikasi kompatibel melalui satu endpoint yang dikelola.

Buat access key

Buat akun, pilih paket, lalu buat API key khusus berawalan gnx_... dari dashboard. Simpan full key dengan aman karena hanya ditampilkan saat dibuat.

Buat akun

Gunakan Claude Code

Claude Code Compatible

Claude Code adalah integrasi yang direkomendasikan. Endpoint Anthropic-compatible Gaionix mendukung streaming, tool use, dan workflow coding multi-turn.

Claude Code Terminal

  1. Pasang Claude Code lalu buka terminal pada folder proyek.
  2. Atur gateway URL dan access key.
  3. Mulai Claude Code dengan tier pilihan Anda.
export ANTHROPIC_BASE_URL="https://semeru.gaionix.com/api/gateway/anthropic"
export ANTHROPIC_AUTH_TOKEN="gnx_your_api_key"

cd /path/to/your-project
claude --model sonnet

Pilih haiku, sonnet, atau opus untuk memilih tier gateway. Tambahkan dua baris export ke shell profile jika ingin pengaturan tetap tersimpan.

Claude Code Panel

Untuk Claude Code Panel di VS Code, simpan environment gateway pada file pengaturan lokal Claude.

  1. Buka C:\\Users\{USERNAME PC}\\.claude\\settings.json dengan VS Code atau Notepad.
  2. Jika sudah terdapat konfigurasi lain, pertahankan konfigurasi tersebut dan tambahkan bagian env.
  3. Reload VS Code setelah menyimpan file.
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://semeru.gaionix.com/api/gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "gnx_your_api_key"
  }
}

Contoh path: C:\\Users\\Budi\\.claude\\settings.json. Jika file sudah berisi pengaturan, gabungkan blok env tanpa mengganti seluruh file.

API kompatibel

Pilih format endpoint yang didukung aplikasi Anda. Keduanya menggunakan API key khusus berawalan gnx_....

Video tutorial setup
Anthropic Compatible

Messages API

Untuk Claude Code, provider Anthropic pada Cline, atau aplikasi yang menggunakan Anthropic Messages API.

POST https://semeru.gaionix.com/api/gateway/anthropic/v1/messages
x-api-key: gnx_your_api_key
OpenAI Compatible

Chat Completions API

Untuk LibreChat, Chatbox, atau aplikasi yang dibuat untuk OpenAI Chat Completions API.

POST https://semeru.gaionix.com/api/gateway/openai/v1/chat/completions
Authorization: Bearer gnx_your_api_key

Model dan Harga

Bandingkan estimasi biaya penggunaan dalam kredit Gaionix sebelum menghubungkan aplikasi Anda.

Cline

Anthropic CompatibleOpenAI Compatible

Cline mendukung dua format Gaionix. Untuk tool protocol native, pilih Anthropic dan aktifkan Use custom base URL.

Anthropic Compatible — direkomendasikan

Base URL
https://semeru.gaionix.com/api/gateway/anthropic/v1
API Key
gnx_your_api_key
Model
claude-sonnet-4-6

Alternatif OpenAI Compatible

Base URL
https://semeru.gaionix.com/api/gateway/openai/v1
API Key
gnx_your_api_key
Model ID
sonnet

Cursor IDE

OpenAI Compatible

Gunakan override OpenAI Base URL pada Cursor untuk mengarahkan request chat kompatibel melalui Gaionix.

  1. 01

    Buka Cursor Settings

    Buka Settings, lalu cari bagian Models atau API Keys.

  2. 02

    Aktifkan override

    Aktifkan opsi "Override OpenAI Base URL".

  3. 03

    Masukkan kredensial Gaionix

    Isi Base URL dengan https://semeru.gaionix.com/api/gateway/openai/v1 dan masukkan gnx_ API key.

  4. 04

    Pilih model publik

    Pilih model pada tabel OpenAI-compatible lalu simpan.

Pilih salah satu model yang ditampilkan pada tabel OpenAI-compatible di atas.

OpenClaw

OpenAI Compatible

OpenClaw menjalankan autonomous AI agent secara terus-menerus, umumnya di VPS atau Docker. OpenClaw mengikuti variabel environment standar OpenAI, sehingga seluruh request dapat diarahkan ke Gaionix tanpa mengubah alur kerja agent Anda.

Variabel environment

Buat atau perbarui file .env yang dipakai OpenClaw. Ganti YOUR_PUBLIC_MODEL_ID dengan ID model persis dari tabel model OpenAI-compatible.

# Gateway Gaionix OpenAI-compatible
OPENAI_API_BASE=https://semeru.gaionix.com/api/gateway/openai/v1
OPENAI_API_KEY=gnx_your_api_key
OPENAI_MODEL=YOUR_PUBLIC_MODEL_ID

Docker Compose

Untuk deployment Docker, tambahkan nilai yang sama pada environment service OpenClaw, lalu buat ulang atau restart container.

services:
  openclaw:
    environment:
      OPENAI_API_BASE: "https://semeru.gaionix.com/api/gateway/openai/v1"
      OPENAI_API_KEY: "gnx_your_api_key"
      OPENAI_MODEL: "YOUR_PUBLIC_MODEL_ID"
ID model: gunakan ID model persis seperti yang terlihat pada tabel di bawah, tanpa prefix provider. Contoh: xiaomi/mimo-v2.5.
docker compose up -d
docker compose logs -f openclaw

Pilih salah satu model yang ditampilkan pada tabel OpenAI-compatible di atas.

LibreChat & Chatbox

Kedua aplikasi menggunakan endpoint OpenAI-compatible Gaionix. Gunakan API key khusus untuk aplikasi atau workspace agar usage mudah ditinjau.

LibreChat

OpenAI Compatible

Simpan key pada .env, lalu daftarkan Gaionix sebagai custom endpoint pada librechat.yaml.

# .env
GAIONIX_API_KEY=gnx_your_api_key

# librechat.yaml
endpoints:
  custom:
    - name: "Gaionix"
      apiKey: "${GAIONIX_API_KEY}"
      baseURL: "https://semeru.gaionix.com/api/gateway/openai/v1"
      models:
        default: []
        fetch: true
      titleConvo: true

Restart LibreChat setelah menyimpan konfigurasi. fetch: true memungkinkan aplikasi memuat model OpenAI-compatible publik yang tersedia.

Chatbox

OpenAI Compatible
  1. 01

    Buka settings

    Buka Settings → Model lalu tambahkan custom provider.

  2. 02

    Pilih tipe provider

    Pilih OpenAI API Compatible.

  3. 03

    Masukkan endpoint dan key

    Isi API Host dengan https://semeru.gaionix.com/api/gateway/openai dan masukkan gnx_ API key.

  4. 04

    Pilih model

    Pilih model yang ditampilkan pada tabel model OpenAI-compatible lalu simpan.

Pilih salah satu model yang ditampilkan pada tabel OpenAI-compatible di atas.

API Host: gunakan https://semeru.gaionix.com/api/gateway/openai tanpa /v1 terakhir karena Chatbox menambahkannya sendiri.

Penggunaan kredit

Penggunaan kredit dipengaruhi tier yang dipilih serta ukuran request dan respons. Dashboard menampilkan sisa kredit dan riwayat request Anda.

Buat key khusus untuk setiap proyek
Gunakan tier yang sesuai dengan tugas
Tinjau usage pada dashboard