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/v1Jika aplikasi menanyakan URL endpoint spesifik, gunakan:
https://router.clouvia.id/v1/responses3
Masukkan API Key Clouvia
Gunakan API Key aktif yang berawalanclv_live_.... Pastikan scope kunci mengizinkan akses gateway.4
Pilih Model AI
Ketik atau pilihcoding-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?" } ] }'