Quickstart

Dari daftar sampai request pertama

Salin salah satu contoh di bawah, sesuaikan API key Anda, dan jalankan. Model qwen-35b-fast siap merespons secara instan.

curl https://primecode.id/v1/chat/completions \
  -H "Authorization: Bearer sk-primecode-live-YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-35b-fast",
    "messages": [
      {"role": "user", "content": "Halo! Jelaskan perbedaan asynchronous dan multithreading secara ringkas."}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://primecode.id/v1",
    api_key="sk-primecode-live-YOUR_SECRET_KEY",
)

response = client.chat.completions.create(
    model="qwen-35b-fast",
    messages=[
        {"role": "user", "content": "Halo dari Python SDK!"}
    ],
)

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

const response = await fetch("https://primecode.id/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-primecode-live-YOUR_SECRET_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "qwen-35b-fast",
    messages: [{ role: "user", content: "Halo dari Node.js!" }]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);

<?php
$payload = json_encode([
    'model' => 'qwen-35b-fast',
    'messages' => [['role' => 'user', 'content' => 'Halo dari PHP Native / Laravel!']]
]);

$ch = curl_init('https://primecode.id/v1/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-primecode-live-YOUR_SECRET_KEY',
        'Content-Type: application/json'
    ]
]);

$res = curl_exec($ch);
curl_close($ch);
echo $res;

Kredensial API

Isikan Base URL, tempel API Key

Prinsip koneksi ke seluruh ekstensi & IDE selalu identik: masukkan Base URL dan API Key Anda.

Masuk untuk Kunci Anda

Nama Parameter	Nilai yang Dimasukkan	Aksi
Base URL (Format OpenAI: VS Code, CodeGPT, Cursor, Continue)	`https://primecode.id/v1`
Base URL (Format Anthropic: Claude Code CLI — tanpa /v1)	`https://primecode.id` (klien Anthropic menambahkan /v1/messages otomatis)
API Key (Bearer Token Akun Anda)	`sk-primecode-live-YOUR_SECRET_KEY`
Model ID Contoh (Fleksibel dengan atau tanpa prefix vendor)	`qwen-35b-fast`

Editor & Tools

Mana yang paling cocok untuk Anda?

Pilih tool atau ekstensi favorit Anda di bawah untuk langsung membuka panduan instalasi spesifiknya:

1-Klik PowerShell

Auto 34 Model

Paling instan untuk Windows & VS Code. Cukup paste 1 baris perintah di PowerShell, seluruh 34 model langsung terpasang.

Lihat perintah →

CodeGPT (VS Code)

Didukung

Ekstensi chat dan agent AI di sidebar kanan VS Code. Terhubung via menu Local Provider dengan Base URL /v1.

Buka panduan →

Cline & Roo Code

Didukung

Autonomous coding agent paling populer di VS Code. Bisa membaca workspace, mengedit kode, dan mengeksekusi terminal.

Buka panduan →

Cursor IDE

Didukung

Editor AI-first mandiri. Aktifkan sakelar Override OpenAI Base URL di menu Settings Models.

Buka panduan →

Claude Code CLI

Didukung

Agent terminal dari Anthropic untuk refactor skala besar. Setup hanya 4 baris environment variable.

Buka panduan →

Windsurf Cascade

Didukung

IDE cerdas berbasis Codeium dengan agent Cascade. Konfigurasi model kustom via Base URL OpenAI.

Buka panduan →

Continue.dev

Didukung

Ekstensi open-source untuk VS Code & JetBrains. Konfigurasi mudah lewat file JSON atau YAML.

Buka panduan →

9Router Gateway

Didukung

Router cerdas lokal dengan fitur auto-failover, model aliasing, dan pengelolaan token terpusat.

Buka panduan →

Codex CLI & OpenCode

Didukung

Agent terminal open-source dengan dukungan protokol custom provider lewat satu file toml/json.

Buka panduan →

Aktivasi 1 Perintah (Tanpa Aplikasi)

Sambungkan Seluruh Model AI ke VS Code via PowerShell

Cukup tempel 1 baris perintah di Windows PowerShell. Seluruh model PrimeCode AI akan otomatis terpasang langsung di panel Copilot Chat bawaan VS Code tanpa perlu aplikasi tambahan!

Waktu Setup: ~4 Detik

Pilihan 1: Copilot Chat (Native VS Code - Paling Mudah):

> $env:PRIMECODE_KEY="sk-primecode-live-YOUR_SECRET_KEY"; irm https://primecode.id/download/copilot.ps1 | iex

* Menyuntikkan konfigurasi ke chatLanguageModels.json dan mengalihkan harness chat ke mode Local sehingga bebas dari langganan akun GitHub Copilot.

Pilihan 2: Ekstensi Continue.dev (PowerShell):

> irm https://primecode.id/install/vscode | iex

Pilihan 3: macOS / Linux Terminal (Bash):

$ curl -fsSL https://primecode.id/install/vscode.sh | bash

1

Tutorial CodeGPT (VS Code Extension)

Pasang di sidebar chat VS Code, gunakan model kustom, dan hindari error guardrail

Langkah 1: Pasang & Buka Menu

Buka menu Extensions di VS Code (Ctrl + Shift + X).
Cari CodeGPT: AI Coding Agents & Chat (oleh Daniel San), lalu klik Install.
Klik ikon CodeGPT di sidebar paling kiri atau tombol CODEGPT di status bar kanan bawah.
Di panel CodeGPT, buka menu Manage AI Models (ikon gerigi di atas atau dropdown provider di bawah).
Pilih tab Local di bagian atas jendela pengaturan.

Langkah 2: Isi Formulir Koneksi

1. Provider: Custom (any OpenAI-compatible server)

2. Kolom URL (Wajib sertakan /v1):

https://primecode.id/v1

3. Kolom API Key:

sk-primecode-live-YOUR_SECRET_KEY

4. Verifikasi & Simpan: Klik tombol Test sampai lampu indikator hijau menyala. Buka dropdown Model dan pilih model resmi Anda (misal qwen-35b-fast). Klik Save & close.

Cara Mencegah Pesan "Model ended turn without response / internal guardrail":
Di pojok kiri bawah kotak chat CodeGPT (di bawah kolom ketik), periksa dropdown model yang aktif. Pastikan memilih model Custom / Local yang baru Anda simpan. Jangan memilih model yang berawalan ag: (seperti ag:gemini-3.5-flash), karena awalan ag: dialihkan ke cloud CodeGPT yang terbatas.

2

Tutorial Cline & Roo Code (VS Code Extension)

Setup lewat tampilan antarmuka, tanpa perlu mengedit file konfigurasi manual

1
Install Extension: Buka VS Code, tekan Ctrl+Shift+X, cari Cline (atau Roo Code), klik Install.
2
Buka Pengaturan Cline: Klik ikon Cline di sidebar kiri, lalu klik ikon gerigi Settings di sudut kanan atas panel Cline.
3
Pilih Provider "OpenAI Compatible": Pada dropdown API Provider, pilih OpenAI Compatible (jangan pilih OpenAI standar, karena OpenAI standar sering mengunci Base URL).
4
Isi Tiga Kolom Wajib:

Base URL: https://primecode.id/v1

API Key: sk-primecode-live-YOUR_SECRET_KEY

Model ID: qwen-35b-fast
5
Simpan & Uji: Klik tombol Done di bagian paling bawah. Ketik perintah koding di chat Cline untuk memulai!

3

Claude Code CLI lewat `/v1/messages`

Agent terminal resmi Anthropic untuk tugas multi-file skala besar

Claude Code secara otomatis menambahkan /v1/messages ke Base URL. Cukup definisikan variabel lingkungan berikut di terminal Anda sebelum menjalankan perintah claude:

macOS / Linux (Bash / Zsh)

export ANTHROPIC_BASE_URL="https://primecode.id"
export ANTHROPIC_AUTH_TOKEN="sk-primecode-live-YOUR_SECRET_KEY"
export ANTHROPIC_MODEL="qwen-35b-fast"

claude

Windows (PowerShell)

$env:ANTHROPIC_BASE_URL="https://primecode.id"
$env:ANTHROPIC_AUTH_TOKEN="sk-primecode-live-YOUR_SECRET_KEY"
$env:ANTHROPIC_MODEL="qwen-35b-fast"

claude

3 Hal Penting untuk Claude Code: (1) Gunakan variabel ANTHROPIC_AUTH_TOKEN (bukan ANTHROPIC_API_KEY). (2) Nilai ANTHROPIC_BASE_URL wajib diisi tanpa akhiran /v1. (3) Jalankan perintah claude di jendela terminal yang sama setelah mengatur variabel tersebut.

4

Tutorial Cursor IDE

Integrasi ke editor AI-First Cursor menggunakan fitur Override Base URL

1
Buka Settings → Models: Di Cursor, tekan Ctrl+Shift+J (atau Cmd+, di Mac), lalu klik tab Models di panel samping.
2
Aktifkan Override OpenAI Base URL: Nyalakan sakelar Override OpenAI Base URL, lalu masukkan alamat: https://primecode.id/v1
3
Tempel API Key: Pada kolom OpenAI API Key, tempel kunci API akun Anda, lalu klik tombol Verify untuk menguji koneksi.
4
Tambahkan Model AI: Di bagian model list, klik + Add Model, masukkan nama model (misal qwen-35b-fast atau deepseek-chat). Matikan model bawaan agar Cursor selalu memanggil model platform Anda.

5

Tutorial Continue.dev (VS Code & JetBrains)

Konfigurasi file ~/.continue/config.yaml atau ~/.continue/config.json

Tekan Ctrl+Shift+P di VS Code, ketik Continue: Open Config, lalu tempelkan struktur konfigurasi berikut:

~/.continue/config.yaml

models:
  - name: PrimeCode Coder
    provider: openai
    apiBase: https://primecode.id/v1
    apiKey: sk-primecode-live-YOUR_SECRET_KEY
    model: qwen-35b-fast
    capabilities:
      - tool_use
      - image_input
    roles:
      - chat
      - edit

  - name: PrimeCode Fast
    provider: openai
    apiBase: https://primecode.id/v1
    apiKey: sk-primecode-live-YOUR_SECRET_KEY
    model: deepseek-chat
    roles:
      - chat

tabAutocompleteModel:
  title: PrimeCode Autocomplete
  provider: openai
  model: deepseek-chat
  apiKey: sk-primecode-live-YOUR_SECRET_KEY
  apiBase: https://primecode.id/v1

Windsurf

Windsurf Cascade Agent

Buka Windsurf Settings → cari OpenAI Custom Base URL:

Base URL: https://primecode.id/v1

API Key: sk-primecode-live-YOUR_SECRET_KEY

Model: qwen-35b-fast

9Router

9Router Self-Hosted

Tambahkan provider di dashboard 9Router (http://localhost:20128):

Type: openai-compatible

Base URL: https://primecode.id/v1

API Key: sk-primecode-live-YOUR_SECRET_KEY

Codex CLI

Codex CLI (~/.codex/config.toml)

model = "qwen-35b-fast"
model_provider = "primecode"

[model_providers.primecode]
name = "PrimeCode AI"
base_url = "https://primecode.id/v1"
env_key = "PRIMECODE_API_KEY"
wire_api = "responses"

OpenCode

OpenCode (opencode.json)

{
  "provider": {
    "primecode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PrimeCode AI",
      "options": { "baseURL": "https://primecode.id/v1" },
      "models": { "qwen-35b-fast": { "name": "qwen-35b-fast" } }
    }
  }
}

Vision API

Input Gambar & Multimodal

Model dengan kemampuan Vision (seperti gpt-4o, claude-3-7-sonnet, gemini-2.5-flash, qwen3-vl) dapat menganalisis gambar via URL publik maupun Base64 Data URI secara instan.

Python Vision Payload Contoh:

response = client.chat.completions.create(
    model="claude-3-7-sonnet",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Jelaskan arsitektur diagram pada gambar ini dan temukan potensi bug."},
            {"type": "image_url", "image_url": {"url": "https://domain-anda.com/screenshot.png"}}
        ]
    }]
)
print(response.choices[0].message.content)

Untuk gambar lokal, masukkan sebagai Data URI: data:image/png;base64,<data_base64>.

Billing & Saldo

Dua mode penagihan, satu akun fleksibel

PrimeCode AI memiliki dua mekanisme pembayaran yang dapat digunakan berdampingan secara otomatis:

1. Saldo PAYG (Pay-As-You-Go)

Saldo Rupiah dipotong per token sesuai tarif model. 1 Saldo = Rp1. Saldo tidak pernah kedaluwarsa atau hangus. Prompt caching otomatis aktif dengan diskon hingga 80%.

2. Paket Langganan Unlimited

Kuota tak terbatas selama masa aktif (Harian, Mingguan, Bulanan). Jika paket Unlimited aktif, paket akan otomatis diprioritaskan terlebih dahulu, sementara saldo PAYG menjadi cadangan.

Tabel Perbandingan: Kapan Pakai yang Mana?

Aspek	Paket Unlimited	Saldo PAYG
Biaya	Mulai Rp10.000 / masa aktif	Mulai Rp10.000 deposit via QRIS / VA
Kedaluwarsa	Sesuai durasi paket (1 hari, 7 hari, 30 hari)	Permanen (Saldo tidak pernah hangus)
Kesesuaian Penggunaan	Coding berat harian, autonomous agent, proyek besar	Penggunaan tak menentu, eksperimen, testing API
Prioritas Pemotongan	Prioritas Utama (Dipotong duluan)	Cadangan otomatis jika paket habis

Benchmark & Efisiensi

Lebih hemat hingga 90% dibanding provider hulu

Dibandingkan langsung dengan kartu kredit luar negeri dan router perantara lain:

Model AI	Hemat Biaya	Rata-rata Respon
DeepSeek V3 / R1	−85% s/d −95%	~1.2s
Claude 3.7 Sonnet	−60% s/d −75%	~2.4s
GPT-4o & GPT-4.1	−55% s/d −70%	~1.8s

Troubleshooting

Kode error yang Anda temui & solusinya

Setiap kegagalan request menghasilkan kode HTTP dan pesan JSON yang spesifik. Berikut rangkuman penanganannya:

401 Unauthorized Autentikasi Gagal

Kunci API Tidak Ditemukan / Salah

Pastikan header Authorization: Bearer sk-primecode-... disertakan dan kunci API berstatus active di halaman API Keys.

402 Payment Required Saldo Tidak Cukup

Saldo Habis / Belum Top Up

Saldo akun Anda tidak mencukupi untuk inferensi model ini. Lakukan top-up saldo instan via QRIS di menu Top Up Saldo.

404 Not Found Model Tidak Ada

Model ID Salah / Tidak Aktif

ID model yang diminta tidak terdaftar. Periksa ejaan nama model yang valid pada menu Katalog Model.

429 Rate Limited Batas Laju Tercapai

Terlalu Banyak Permintaan Cepat

Request bersamaan melebihi batas laju paket. Sistem klien (seperti Cline/Cursor) akan otomatis melakukan retry exponential backoff.

Dukungan

Masih membutuhkan bantuan?

Tim teknis kami siap mendampingi proses integrasi ke editor Anda, kendala pembayaran, ataupun kebutuhan kuota enterprise.

Hubungi Bantuan Teknis Coba di AI Playground Status Gateway 99.9%

Mulai request pertama dalam hitungan menit.

Dari daftar sampai request pertama

Isikan Base URL, tempel API Key

Mana yang paling cocok untuk Anda?

1-Klik PowerShell

CodeGPT (VS Code)

Cline & Roo Code

Cursor IDE

Claude Code CLI

Windsurf Cascade

Continue.dev

9Router Gateway

Codex CLI & OpenCode

Sambungkan Seluruh Model AI ke VS Code via PowerShell

Tutorial CodeGPT (VS Code Extension)

Tutorial Cline & Roo Code (VS Code Extension)

Claude Code CLI lewat /v1/messages

Tutorial Cursor IDE

Tutorial Continue.dev (VS Code & JetBrains)

Windsurf Cascade Agent

9Router Self-Hosted

Codex CLI (~/.codex/config.toml)

OpenCode (opencode.json)

Input Gambar & Multimodal

Dua mode penagihan, satu akun fleksibel

1. Saldo PAYG (Pay-As-You-Go)

2. Paket Langganan Unlimited

Tabel Perbandingan: Kapan Pakai yang Mana?

Lebih hemat hingga 90% dibanding provider hulu

Kode error yang Anda temui & solusinya

Kunci API Tidak Ditemukan / Salah

Saldo Habis / Belum Top Up

Model ID Salah / Tidak Aktif

Terlalu Banyak Permintaan Cepat

Masih membutuhkan bantuan?

Claude Code CLI lewat `/v1/messages`