Panduan penggunaan

Dokumentasi Router AI

Panduan singkat memakai API Router AI dari aplikasi OpenAI-compatible seperti Cline atau OpenCode, serta memakai ChatHub.

1. Siapkan API key

Beli paket di halaman Store.
Setelah pembayaran lunas, API key tampil di modal invoice dan dikirim ke email pembelian. Simpan key secara rahasia.
Untuk menambah saldo, gunakan fitur cek saldo dan top-up dengan API key yang sama.

Jangan masukkan API key ke kode frontend, repositori publik, atau percakapan yang bisa diakses orang lain. Gunakan sebagai secret di konfigurasi aplikasi.

2. Konfigurasi aplikasi API

Atur aplikasi klien ke base URL berikut, lalu masukkan API key sebagai Bearer token. Base URL untuk server ini adalah /v1.

Authorization: Bearer API_KEY_ANDA
Base URL: https://alamat-server-anda/v1

Jika aplikasi meminta endpoint, pilih salah satu yang didukung:

POST /v1/responsesPOST /v1/chat/completions

Gunakan endpoint dan format yang cocok dengan pilihan klien. Untuk Cline atau OpenCode, pilih provider OpenAI-compatible lalu isi base URL, API key, dan model.

Bahasa jawaban mengikuti header Accept-Language dari klien, misalnya Accept-Language: id-ID atau Accept-Language: en-US. Jika header tidak dikirim, bahasa mengikuti pesan pengguna; sapaan singkat memakai Bahasa Indonesia sebagai default.

Akun Codex dipilih merata per task dan tetap sama selama task berlangsung. Kirim header X-Task-Id yang stabil untuk semua request dalam satu task; gunakan nilai baru ketika memulai task baru. ChatHub mengirim ID percakapan secara otomatis.

3. Lihat model yang tersedia

Klien dapat mengambil daftar model aktif melalui GET /v1/models. Pilih nilai id dari hasilnya sebagai nama model request.

GET https://alamat-server-anda/v1/models
Authorization: Bearer API_KEY_ANDA

Model aktif bergantung pada akun dan pengaturan admin di Router AI.

4. Contoh request chat

Contoh format untuk endpoint Chat Completions:

POST https://alamat-server-anda/v1/chat/completions
Authorization: Bearer API_KEY_ANDA
Content-Type: application/json

{
  "model": "MODEL_DARI_V1_MODELS",
  "messages": [
    { "role": "user", "content": "Halo, bantu saya." }
  ]
}

Request teks juga dapat memakai streaming jika klien mendukungnya. Gateway meneruskan jawaban dari model yang tersedia pada akun terhubung.

5. Gunakan ChatHub

Pilih Masuk ChatHub di Store, masukkan API key, lalu mulai percakapan. Sesi login disimpan sebagai cookie aman pada browser. Riwayat percakapan disimpan di database dan terpisah untuk tiap API key.

Pemakaian model di ChatHub mengurangi saldo token key yang digunakan. Unduhan file dari jawaban, seperti PDF, Word, Excel, atau TXT, tidak membuat request model tambahan.

6. Kuota dan saldo

Satu kredit paket setara dengan 1.000.000 token batas kuota.
Penggunaan dihitung dari token input dan output, dikurangi cached token, lalu dikalikan pengali model.
Saldo paket berlaku 30 hari sejak pembelian atau top-up lunas terakhir.
Saldo dan riwayat pembelian dapat dilihat melalui halaman cek saldo di Store.

Lihat paket Cek saldo