Clouvia RouterClouvia Router
Konsol Client →
PANDUAN INTEGRASI · UPSTREAM GATEWAY

Koneksi ke 9Router Gateway

Panduan lengkap mengintegrasikan Clouvia Router sebagai upstream provider OpenAI-compatible pada 9Router. Cocok untuk load balancing multi-provider, fallback routing, dan manajemen AI pool terpusat.

TARGET ENGINE:9Router (v0.5+)
PROVIDER TYPE:OpenAI Compatible
PREFIX MODEL:clouvia/<slug>
MANFAAT UPSTREAM CLOUVIA DI 9ROUTER
Dengan menyambungkan Clouvia Router ke 9Router, Anda mendapatkan upstream berkecepatan tinggi dengan latensi overhead kernel sub-15ms, dukungan model coding otonom coding-high, serta proteksi saldo kuota token transaksional yang tidak pernah kedaluwarsa.
1

Dapatkan API Key Khusus Upstream

Buka menu API Key di konsol client Clouvia Router. Terbitkan key baru dengan label '9Router Upstream Proxy' dan simpan secret clv_live_... Anda.

2

Konfigurasi Provider Baru di 9Router

Akses dashboard admin 9Router Anda (atau buka file konfigurasi JSON / database SQLite di server Anda), lalu tambahkan provider baru dengan parameter berikut:

ParameterNilai KonfigurasiCatatan
Provider IDclouviaPrefix pemanggilan model: clouvia/<model>
Provider TypeopenaiProtokol standar OpenAI compatible v1
Base URLhttps://router.clouvia.id/v1Wajib menyertakan akhiran /v1 tanpa trailing slash
API Keyclv_live_xxxxxxxxxxxxxxxxxxxxxxxxKey aktif dari akun Clouvia Router Anda
3

Salin Cuplikan Konfigurasi JSON Provider

Jika sistem 9Router Anda dikonfigurasi melalui file models.json atau skrip runtime, Anda dapat menyalin struktur konfigurasi berikut:

Konfigurasi Upstream Provider 9Routerjson
1{
2  "id": "clouvia",
3  "name": "Clouvia Router",
4  "type": "openai",
5  "baseUrl": "https://router.clouvia.id/v1",
6  "apiKey": "clv_live_xxxxxxxxxxxxxxxxxxxxxxxx",
7  "models": [
8    "coding-high",
9    "claude-opus-4.6",
10    "claude-sonnet-4.6",
11    "gpt-5.6-luna",
12    "gemini-3.8-flash-low"
13  ]
14}
4

Uji Pemanggilan Upstream via 9Router

Lakukan pengujian request ke port proxy lokal 9Router Anda (default port 20128) untuk memastikan routing upstream berjalan sempurna:

Terminal cURL Test via 9Routerbash
1curl http://127.0.0.1:20128/v1/chat/completions \
2  -H "Authorization: Bearer your_9router_client_token" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "clouvia/coding-high",
6    "messages": [
7      {"role": "user", "content": "Halo dari 9Router upstream mesh!"}
8    ]
9  }'

9Router akan meneruskan request ke Clouvia Router, memetakan token header, dan mengembalikan streaming chunk kembali ke pemanggil.

Tips Optimasi Nginx Reverse Proxy (Keep-Alive)

SERVER OPS

Jika 9Router Anda berada di balik reverse proxy Nginx, pastikan Anda menyertakan direktif proxy_set_header Connection ""; untuk mengaktifkan HTTP keep-alive connection pooling. Ini mencegah terjadinya error parsing socket dan menghemat latensi handshake TCP:

/etc/nginx/sites-available/9routernginx
1location /v1/ {
2    proxy_pass http://127.0.0.1:20128;
3    proxy_http_version 1.1;
4    proxy_set_header Connection "";
5    proxy_set_header Host $host;
6    proxy_set_header X-Real-IP $remote_addr;
7}