Docs

Dokumentasi

Hubungkan tool OpenAI & Anthropic compatible ke NilovrAI. Key kamu hanya membuka model aktif di katalog.

Isi halaman

Quick start Request pertama List models Streaming Cursor Cline / VS Code OpenCode Claude Code Codex CLI GitHub Copilot Kilo Code Error codes Aturan penting FAQ Bantuan

Quick start

• Base URL: https://api.nilovr.com/v1
• API Key: dari portal — terbit otomatis saat daftar
• Model: semua model aktif di katalog
• Kredit prabayar via QRIS — tidak ada langganan, tidak hangus

OpenAI-compatible request

Endpoint utama mengikuti format OpenAI persis — semua tool compatible langsung jalan:

bash

curl https://api.nilovr.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "halo!"}],
    "max_tokens": 64
  }'

Format Anthropic juga didukung native:

bash

curl https://api.nilovr.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "halo!"}]
  }'

List model yang bisa dipakai

bash

curl https://api.nilovr.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Respons difilter sesuai katalog aktif — model yang dinonaktifkan otomatis hilang dari daftar.

Streaming (SSE)

Tambahkan "stream": true untuk respons token-per-token, format SSE standar OpenAI:

bash

curl https://api.nilovr.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "stream": true,
    "messages": [{"role": "user", "content": "tulis puisi"}]
  }'

JavaScript / Node.js

Gunakan SDK resmi OpenAI — cukup ganti baseURL dan apiKey:

Terminal

npm install openai

index.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.nilovr.com/v1",
  apiKey: process.env.NILOVR_API_KEY,
});

const res = await client.chat.completions.create({
  model: "glm-5.3",
  messages: [{ role: "user", content: "halo!" }],
});
console.log(res.choices[0].message.content);

Simpan key di file .env (jangan hardcode):

.env

NILOVR_API_KEY=sk-nilovr-xxxxxxxxxxxxxxxx

Penting untuk bot Telegram/whatsapp (node --env-file=.env): pastikan nama variabel di .env sama persis dengan yang dibaca kode. Error 401 invalid api key hampir selalu berarti variabel kosong/salah nama — cek dengan console.log(process.env.NILOVR_API_KEY).

Python

SDK OpenAI Python dengan cara yang sama:

Terminal

pip install openai

bot.py

from openai import OpenAI

client = OpenAI(
    base_url="https://api.nilovr.com/v1",
    api_key="sk-nilovr-xxxxxxxxxxxxxxxx",
)

res = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "halo!"}],
)
print(res.choices[0].message.content)

Cursor

Settings → Models → aktifkan OpenAI API Key:

Override Base URL: https://api.nilovr.com/v1
API Key: YOUR_API_KEY
Model: salah satu ID model dari katalog

Cline / VS Code

API Provider: OpenAI Compatible
Base URL: https://api.nilovr.com/v1
API Key: YOUR_API_KEY
Model: glm-5.3 (atau model lain)

OpenCode

File ~/.config/opencode/opencode.json — semua model di katalog bisa dipakai sebagai coding agent (gratis maupun berbayar). Daftarkan tiap model di blok models, lalu pilih lewat /models di dalam OpenCode:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "nilovrai/kimi-k2.8",
  "small_model": "nilovrai/deepseek-v4.1-flash",
  "permission": "allow",
  "provider": {
    "nilovrai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NilovrAI",
      "options": {
        "baseURL": "https://api.nilovr.com/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "kimi-k2.8": { "name": "Kimi K2.8", "tool_call": true },
        "claude-opus-5.5": { "name": "Claude Opus 5.5", "tool_call": true },
        "gpt-6-astra": { "name": "GPT 6 Astra", "tool_call": true },
        "glm-5.3": { "name": "GLM 5.3", "tool_call": true },
        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash", "tool_call": true },
        "mimo-v2.6-pro": { "name": "MiMo V2.6 Pro", "tool_call": true }
      }
    }
  }
}

Nama di model harus sama dengan salah satu kunci di models, dan tool_call: true wajib supaya model bisa memakai tool. Atau pakai Auto Config di halaman Tutorial platform — satu perintah, config lama digabung & dibackup, seluruh katalog ditampilkan.

Claude Code

File ~/.claude/settings.json — mapping model Anthropic ke slug NilovrAI (fable/sonnet/opus/haiku):

settings.json

{
  "model": "sonnet",
  "hasCompletedOnboarding": true,
  "enableWorkflows": true,
  "effortLevel": "xhigh",
  "skipWorkflowUsageWarning": true,
  "theme": "dark",
  "permissions": {
    "defaultMode": "bypassPermissions"
  },
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nilovr.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Pakai salah satu kunci saja: ANTHROPIC_AUTH_TOKEN seperti contoh, atau ANTHROPIC_API_KEY dengan nilai yang sama.

Endpoint /v1/messages dan /v1/messages/count_tokens aktif otomatis untuk key kamu (mendukung streaming dan pemanggilan alat).

Cek cepat: claude -p "sebutkan satu warna". Kalau muncul jawaban, sambungan sudah benar.

Codex CLI

File ~/.codex/config.toml — export key sebagai env var NILOVR_API_KEY:

config.toml

model = "glm-5.3"
model_provider = "nilovrai"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.nilovrai]
name = "NilovrAI"
base_url = "https://api.nilovr.com/v1"
env_key = "NILOVR_API_KEY"
wire_api = "responses"
stream_max_retries = 3
stream_idle_timeout_ms = 300000

bash

export NILOVR_API_KEY=YOUR_API_KEY
codex

Cek cepat: codex exec "sebutkan satu warna". Kalau muncul jawaban, sambungan sudah benar.

Pesan "Model metadata not found" di Codex aman diabaikan selama jawaban tetap muncul: Codex cuma belum mengenal nama model NilovrAI.

GitHub Copilot

File ~/.copilot/ai-models.json — daftarkan model NilovrAI ke Copilot Chat (VS Code 2026+ / native model config):

ai-models.json

[
  {
    "chatLanguageModels": [
      {
        "id": "glm-5.3",
        "name": "GLM 5.3",
        "url": "https://api.nilovr.com/v1",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 200000,
        "maxOutputTokens": 64000
      },
      {
        "id": "kimi-k2.8",
        "name": "Kimi K2.8",
        "url": "https://api.nilovr.com/v1",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 200000,
        "maxOutputTokens": 64000
      },
      {
        "id": "claude-opus-5.5",
        "name": "Claude Opus 5.5",
        "url": "https://api.nilovr.com/v1",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 200000,
        "maxOutputTokens": 64000
      },
      {
        "id": "deepseek-v4.1-flash",
        "name": "DeepSeek V4.1 Flash",
        "url": "https://api.nilovr.com/v1",
        "toolCalling": true,
        "vision": false,
        "maxInputTokens": 200000,
        "maxOutputTokens": 64000
      }
    ]
  }
]

Kilo Code

Settings Kilo Code (VS Code) — pilih provider OpenAI Compatible:

settings.json

{
  "kilocode.provider": "openai-compatible",
  "kilocode.openAiBaseUrl": "https://api.nilovr.com/v1",
  "kilocode.openAiApiKey": "YOUR_API_KEY",
  "kilocode.openAiModelId": "glm-5.3"
}