# Base URL dan autentikasi

> Base URL Vikey untuk format OpenAI, Anthropic, dan Token Plan, cara mengirim API key, dan header opsional.

## 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.

```http
Authorization: Bearer API_KEY_KAMU
```

```http
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](/api/errors/)).

Source: https://docs.vikey.ai/base-url/