PANDUAN INTEGRASI · RESPONSES API & CLI
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
SPEK PROTOKOL:OpenAI Responses API (/v1/responses)
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, dukungan context compaction (/v1/responses/compact), dan auto-mapping model kustom seperti Custom Light ke engine AI performa tinggi.1. Menghubungkan OpenAI Codex CLI
OpenAI Codex CLI v0.140+ memanggil endpoint Responses API secara default. Cukup arahkan Base URL ke Clouvia Router dan sertakan API Key Anda:
bash
export OPENAI_BASE_URL="https://router.clouvia.id/v1"export OPENAI_API_KEY="clv_live_YOUR_API_KEY"export CODEX_MODEL="coding-high" codex "Buat fungsi binary search di TypeScript"Konfigurasi File Permanen (~/.codex/config.json)
json
{ "api_base": "https://router.clouvia.id/v1", "api_key": "clv_live_YOUR_API_KEY", "model": "coding-high"}2. 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 gunakan preset bawaan seperti Custom Light. Gateway Clouvia secara otonom memetakan permintaan model custom ke model aktif tanpa menimbulkan 404.3. 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?" } ] }'