CONSOLE // NODE_WORKSPACE

Panduan Integrasi Developer

Langkah implementasi praktis untuk AI coding clients (Cline, Hermes, OpenCode, 9router), SDK Python/Node.js, dan migrasi drop-in.

KONEKSI AI CODING CLIENTS & AGENTS

Pilih client favorit Anda untuk melihat konfigurasi drop-in dan contoh pengaturan.

Cline (VS Code)

Autonomous Agent

Autonomous coding agent untuk VS Code yang dapat membaca file, menulis kode, dan mengeksekusi terminal.

MODEL REKOMENDASI:deepseek-v4-pro

LANGKAH KONFIGURASI

  1. 1Buka ekstensi Cline di VS Code, lalu klik ikon Settings (gir) di pojok kanan atas panel Cline.
  2. 2Pada dropdown "API Provider", pilih "OpenAI Compatible".
  3. 3Isikan Base URL dengan endpoint gateway Koneva: https://koneva.asia/v1
  4. 4Masukkan API Key Koneva Anda (diawali dengan kg_live_...).
  5. 5Ketikkan Model ID yang ingin digunakan (contoh: deepseek-v4-pro atau claude-3-5-sonnet).
  6. 6Klik Save/Done. Cline kini terhubung ke Koneva dengan penagihan saldo Rupiah!

Tips Pro: Model deepseek-v4-pro memberikan hasil coding terbaik dengan biaya per token jauh lebih hemat dibandingkan model frontier konvensional.

PARAMETER PENGATURAN
VS Code Settings > Cline ProviderUI
// Pengaturan Form Cline di VS Code:
API Provider  : OpenAI Compatible
Base URL      : https://koneva.asia/v1
API Key       : kg_live_YOUR_API_KEY
Model ID      : deepseek-v4-pro
Context Window: 128000
ENDPOINT BASE URL:https://koneva.asia/v1
FORMAT TOKEN AUTH:Bearer kg_live_...

SDK QUICKSTART: PYTHON

Gunakan package openai resmi, cukup ubah base_url dan api_key.

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("KONEVA_BASE_URL", "https://koneva.asia/v1"),
    api_key=os.environ.get("KONEVA_API_KEY", "kg_live_YOUR_API_KEY")
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "Anda asisten yang ringkas."},
        {"role": "user", "content": "Buat 3 tips optimasi PostgreSQL"}
    ],
    stream=False
)

print(response.choices[0].message.content)
print(response.usage)

SDK QUICKSTART: NODE.JS / TYPESCRIPT

Konfigurasi OpenAI client dengan baseURL gateway Koneva.

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: process.env.KONEVA_BASE_URL || 'https://koneva.asia/v1',
  apiKey: process.env.KONEVA_API_KEY || 'kg_live_YOUR_API_KEY',
});

async function run() {
  const response = await client.chat.completions.create({
    model: 'deepseek-v4-flash',
    messages: [
      { role: 'system', content: 'Anda asisten coding.' },
      { role: 'user', content: 'Tulis fungsi debounce JS sederhana.' },
    ],
    stream: false,
  });

  console.log(response.choices[0].message.content);
  console.log(response.usage);
}

run().catch(console.error);

MIGRASI DROP-IN 30 DETIK

Untuk proyek yang sudah pakai OpenAI, biasanya cukup ubah env berikut:

# Cukup ubah variabel lingkungan:
OPENAI_BASE_URL="https://koneva.asia/v1"
OPENAI_API_KEY="kg_live_YOUR_KONEVA_KEY"

# Method SDK, format messages, dan parsing response tetap sama.

STRATEGI ERROR HANDLING

  • [401]Cek API key aktif dan format Bearer token.
  • [402]Pastikan saldo cukup dan belum melewati masa aktif 30 hari.
  • [429]Gunakan exponential backoff + jitter saat menyentuh rate limit RPM.
  • [502/504]Retry aman; saldo hold dirilis otomatis saat terjadi kegagalan upstream.