Clouvia RouterRouter ClouviaID
PANDUAN INTEGRASI · RESPONSES API & CLI (TERBARU)

Koneksi ke OpenAI Codex CLI & Desktop App

Panduan menyambungkan OpenAI Codex CLI, ChatGPT Desktop with Work with Apps, serta tool generasi baru yang menggunakan OpenAI Responses API (/v1/responses) ke Clouvia Router.

TARGET:OpenAI Codex CLI, Desktop App
BASE URL:https://router.clouvia.id/v1
FORMAT CONFIG:config.toml (Resmi v0.140+)
RESPONSES API (/v1/responses) AKTIF LENGKAP
Clouvia Router mendukung spesifikasi OpenAI Responses API (/v1/responses) secara penuh, termasuk streaming Server-Sent Events (SSE) dengan sequence numbering resmi, context compaction (/v1/responses/compact), dan auto-mapping model kustom seperti coding-high ke engine AI performa tinggi.

1. Cara Cepat: Menghubungkan Codex CLI via Terminal

OpenAI Codex CLI dapat membaca kredensial langsung dari Environment Variable. Pilih platform terminal Anda di bawah ini:

powershell
# Cara 1: Jalankan langsung di terminal sesi ini
$env:OPENAI_BASE_URL = "https://router.clouvia.id/v1"
$env:OPENAI_API_KEY = "clv_live_YOUR_API_KEY"
$env:CODEX_MODEL = "coding-high"
# Cara 2: Simpan permanen di sistem Windows (Cukup jalankan sekali)
[System.Environment]::SetEnvironmentVariable('OPENAI_BASE_URL', 'https://router.clouvia.id/v1', 'User')
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'clv_live_YOUR_API_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('CODEX_MODEL', 'coding-high', 'User')
codex "Buat fungsi binary search di TypeScript"

2. Konfigurasi File Permanen: config.toml & auth.json

Pada versi OpenAI Codex CLI terbaru (v0.140+), konfigurasi provider dan model disimpan dalam format TOML (config.toml) di direktori ~/.codex/ (Windows: %USERPROFILE%\.codex\).

Langkah A: Edit config.tomlLokasi: ~/.codex/config.toml (Tekan Windows + R, ketik %USERPROFILE%\.codex)
toml
# File konfigurasi resmi: ~/.codex/config.toml
# Di Windows: %USERPROFILE%\.codex\config.toml
model = "coding-high"
model_provider = "clouvia"
[model_providers.clouvia]
name = "Clouvia Router"
base_url = "https://router.clouvia.id/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
Langkah B: Masukkan Kunci API (Pilih Salah Satu)Opsi 1: Lewat perintah CLI langsung (Paling Mudah)
bash
# Cara termudah menyimpan API Key tanpa edit file manual:
codex login --with-api-key
# Tempelkan (paste) API Key Clouvia Anda (clv_live_...) saat diminta, lalu tekan Enter.
Opsi 2: Simpan manual ke file ~/.codex/auth.json:
json
// File autentikasi: ~/.codex/auth.json
// Di Windows: %USERPROFILE%\.codex\auth.json
{
"OPENAI_API_KEY": "clv_live_YOUR_API_KEY"
}

3. Pengaturan di Aplikasi Desktop (ChatGPT Work with Apps)

Jika Anda menggunakan aplikasi desktop ChatGPT atau Codex Desktop yang mendukung integrasi lokal dengan aplikasi (Work with Apps):

1

Buka Pengaturan Model / Provider Kustom

Di aplikasi desktop, navigasi ke Settings > Models > Custom Provider atau Work with Apps Settings.
2

Masukkan Base URL Clouvia Router

Isikan field Endpoint URL / Base URL dengan: https://router.clouvia.id/v1
Jika aplikasi menanyakan URL endpoint spesifik, gunakan: https://router.clouvia.id/v1/responses
3

Masukkan API Key Clouvia

Gunakan API Key aktif yang berawalan clv_live_.... Pastikan scope kunci mengizinkan akses gateway.
4

Pilih Model AI

Ketik atau pilih coding-high, atau model frontier lainnya seperti claude-opus-4.8 atau gpt-6-luna. Gateway Clouvia secara otomatis memetakan permintaan model tanpa menimbulkan 404.

4. Verifikasi Langsung via cURL

Non-Streaming (JSON Response)
bash
curl -X POST https://router.clouvia.id/v1/responses \
-H "Authorization: Bearer clv_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "coding-high",
"input": "Halo, tes OpenAI Responses API di Clouvia Router!"
}'
Streaming SSE (Realtime Token Feed)
bash
curl -N -X POST https://router.clouvia.id/v1/responses \
-H "Authorization: Bearer clv_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "coding-high",
"input": "Tuliskan implementasi debounce di JavaScript.",
"stream": true
}'
Context Compaction (/v1/responses/compact)
bash
curl -X POST https://router.clouvia.id/v1/responses/compact \
-H "Authorization: Bearer clv_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "coding-high",
"input": [
{ "role": "user", "content": "Halo sesi sebelumnya" },
{ "role": "assistant", "content": "Hai! Ada yang bisa dibantu?" }
]
}'