Base URL dan autentikasi

Base URL

Pilih base URL sesuai format yang dipakai tool atau SDK kamu.

Untuk	Base URL	Endpoint yang dipakai
SDK atau tool format OpenAI	https://api.vikey.ai/v1	/chat/completions, /responses, /models
SDK atau tool format Anthropic (termasuk Claude Code)	https://api.vikey.ai	/v1/messages
Token Plan	https://api-plan.vikey.ai/v1	Sama dengan format OpenAI, model vikey/plan

Perhatikan /v1

SDK OpenAI butuh base URL dengan /v1. SDK Anthropic dan Claude Code butuh base URL tanpa /v1, karena mereka menambahkan /v1/messages sendiri. Salah satu dari dua ini adalah penyebab error 404 yang paling sering.

Mengirim API key

Kirim key lewat salah satu header ini. Keduanya diterima di semua endpoint.

Authorization: Bearer API_KEY_KAMU

x-api-key: API_KEY_KAMU

SDK OpenAI memakai Authorization: Bearer. SDK Anthropic memakai x-api-key. Kamu tidak perlu mengatur header ini sendiri kalau memakai SDK.

Header opsional

Header	Fungsi
X-End-User	Penanda pengguna akhir kamu sendiri (bukan pengguna Vikey), misalnya id pelanggan di aplikasimu. Dicatat bersama data pemakaian. Isi 1 sampai 128 karakter: huruf, angka, garis bawah, titik, titik dua, atau tanda hubung. Nilai yang tidak valid diabaikan, tidak membuat request gagal. Jangan isi dengan email atau nomor HP.

Cek saldo lewat API

Saldo bisa dilihat di dashboard. Endpoint GET /v1/balance hanya menerima token login dashboard, bukan API key, jadi untuk aplikasi pakai dashboard atau tangani error 402 (lihat Kode error).