# Quickstart

> Dari daftar akun sampai request pertama ke Vikey dalam lima langkah.

1. **Daftar akun.** Buka [vikey.ai/register](https://vikey.ai/register). Kamu bisa daftar dengan email atau Google. Pendaftaran lewat email minta kode 6 digit yang dikirim ke email kamu.

2. **Top up saldo.** Di dashboard, buka **Billing**, lalu **Top up**. Bayar lewat QRIS dari e-wallet atau mobile banking apa pun, mulai Rp10.000. Saldo masuk otomatis setelah pembayaran terkonfirmasi, biasanya dalam hitungan detik. Detailnya ada di [Top up dan saldo](/account/top-up/).

3. **Buat API key.** Buka **API Keys** di dashboard, lalu buat key baru dan beri nama, misalnya `laptop` atau `claude-code`. Simpan key ini di tempat aman. Key inilah yang kamu pakai di semua request.

4. **Kirim request pertama.** Ganti `API_KEY_KAMU` dengan key dari langkah 3.

**curl**

      ```bash
      curl https://api.vikey.ai/v1/chat/completions \
        -H "Authorization: Bearer API_KEY_KAMU" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "openai/gpt-6-luna",
          "messages": [{"role": "user", "content": "Halo, kamu model apa?"}]
        }'
      ```
**Python**

      ```python
      from openai import OpenAI

      client = OpenAI(base_url="https://api.vikey.ai/v1", api_key="API_KEY_KAMU")
      reply = client.chat.completions.create(
          model="openai/gpt-6-luna",
          messages=[{"role": "user", "content": "Halo, kamu model apa?"}],
      )
      print(reply.choices[0].message.content)
      ```
**Node.js**

      ```js
      import OpenAI from 'openai'

      const client = new OpenAI({ baseURL: 'https://api.vikey.ai/v1', apiKey: 'API_KEY_KAMU' })
      const reply = await client.chat.completions.create({
        model: 'openai/gpt-6-luna',
        messages: [{ role: 'user', content: 'Halo, kamu model apa?' }],
      })
      console.log(reply.choices[0].message.content)
      ```

    Response-nya sama dengan format OpenAI: ada `choices` berisi jawaban dan `usage` berisi jumlah token.

5. **Cek pemakaian.** Buka **Usage** di dashboard. Setiap request tercatat per model, lengkap dengan token dan biayanya dalam Rupiah.

**Mau langsung pakai di coding agent?**

Lanjut ke panduan [Claude Code](/agents/claude-code/), [Codex CLI](/agents/codex/), atau [opencode](/agents/opencode/). Kalau tidak mau pusing memilih model, pakai [Vikey Auto](/models/vikey-auto/).

## Kalau request pertama gagal

| Yang kamu lihat | Artinya | Yang perlu dilakukan |
| --- | --- | --- |
| `401` dengan `Invalid API key` | Key salah atau ada spasi ikut tersalin | Salin ulang key dari dashboard |
| `402` dengan `Insufficient balance` | Saldo habis atau tidak cukup untuk request ini | Top up, lalu kirim ulang |
| `404` dengan `Model '...' not found` | Model id salah atau model tidak aktif | Ambil id yang benar dari `GET /v1/models` |

Daftar lengkap ada di [Kode error](/api/errors/).

Source: https://docs.vikey.ai/quickstart/