Dokumentasi API

Satu API untuk
13 model AI.

Hubungkan website, backend, mobile app, atau AI agent ke DKEY lewat API yang kompatibel dengan OpenAI. Satu base URL, satu API key, banyak pilihan model.

Base URLhttps://dkey.my.id/v1

Mulai cepat.

1. Daftar akun. 2. Beli paket kredit. 3. Buka Dashboard dan buat API key. 4. Kirim request dengan model publik dari katalog.

curl https://dkey.my.id/v1/chat/completions \
  -H "Authorization: Bearer dkey_API_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dkey/deepseek-v4-flash-0731",
    "messages": [{"role":"user","content":"Halo"}],
    "max_tokens": 100
  }'

Jangan kirim API key atau password. Simpan key di environment variable atau secret manager. Kalau privat, jangan kirim token di chat — gue ambil lewat gh kalau lo sudah login di VPS ini.

Autentikasi.

Semua endpoint chat membutuhkan header berikut. API key dibuat dari Dashboard dan hanya ditampilkan sekali.

Authorization: Bearer dkey_API_KEY_KAMU

Jangan taruh API key di frontend/browser publik. Untuk aplikasi web, kirim request melalui backend.

Endpoint.

Daftar model

GET /v1/models — publik, tanpa login. Mengembalikan nama model, provider, tier, dan biaya kredit.

curl https://dkey.my.id/v1/models

Chat completions

POST /v1/chat/completions — endpoint utama, kompatibel dengan format OpenAI Chat Completions.

fetch("https://dkey.my.id/v1/chat/completions", {
  method: "POST",
  headers: {"Authorization": `Bearer ${DKEY_API_KEY}`, "Content-Type": "application/json"},
  body: JSON.stringify({model: "dkey/deepseek-v4-flash-0731", messages: [{role: "user", content: "Halo"}]})
})

Streaming

Tambahkan "stream": true. Response dikirim sebagai SSE dan berakhir dengan data: [DONE].

Model & tarif.

Nama model selalu memakai namespace dkey/. Tarif dipotong per request sukses, sesuai tier model.

Model publik	Provider	Tier	Biaya	Cap input / output
`dkey/deepseek-v4-flash-0731`	DeepSeek	Hemat	10 kredit	50.000 / 1.000 token
`dkey/deepseek-v4.1-flash`	DeepSeek	Hemat	10 kredit	50.000 / 1.000 token
`dkey/gpt-6-luna`	OpenAI	Hemat	10 kredit	50.000 / 1.000 token
`dkey/deepseek-v4-pro`	DeepSeek	Standar	20 kredit	100.000 / 2.000 token
`dkey/glm-5.3`	Zhipu	Standar	20 kredit	100.000 / 2.000 token
`dkey/gpt-5.6-terra`	OpenAI	Standar	20 kredit	100.000 / 2.000 token
`dkey/kimi-k2.7`	Moonshot	Standar	20 kredit	100.000 / 2.000 token
`dkey/qwen3.7-max`	Alibaba	Standar	20 kredit	100.000 / 2.000 token
`dkey/claude-opus-5.5`	Anthropic	Premium	30 kredit	200.000 / 3.500 token
`dkey/claude-sonnet-5.5`	Anthropic	Premium	30 kredit	200.000 / 3.500 token
`dkey/gemini-4-argon`	Google	Premium	30 kredit	200.000 / 3.500 token
`dkey/gpt-6-sol`	OpenAI	Premium	30 kredit	200.000 / 3.500 token
`dkey/kimi-k3`	Moonshot	Premium	30 kredit	200.000 / 3.500 token

Setting klien AI.

Semua klien di bawah memakai protokol OpenAI-compatible. Ganti dkey_API_KEY_KAMU dengan API key milikmu. Jangan taruh key di repository publik.

9Router

9Router dipakai sebagai router/failover di depan DKEY. Install dan jalankan 9Router, lalu buka dashboard lokalnya.

npm install -g 9router
9router
# Dashboard: http://localhost:20128/dashboard
# Endpoint 9Router: http://localhost:20128/v1

Di 9Router, tambahkan provider custom/OpenAI-compatible:

Base URL: https://dkey.my.id/v1
API key: dkey_API_KEY_KAMU
Model: salah satu nama dari GET https://dkey.my.id/v1/models, contoh dkey/deepseek-v4-flash-0731

Kalau aplikasi memakai 9Router, gunakan http://localhost:20128/v1 sebagai base URL aplikasinya. Routing dan fallback tetap diatur di 9Router.

Hermes Agent

Jalankan wizard, pilih custom endpoint, atau edit ~/.hermes/config.yaml:

model:
  default: dkey/deepseek-v4-flash-0731
  provider: custom
  base_url: https://dkey.my.id/v1
  key_env: DKEY_API_KEY

export DKEY_API_KEY="dkey_API_KEY_KAMU"
hermes

Alternatif: jalankan hermes model, pilih Custom endpoint, lalu isi base URL, API key, dan model DKEY.

OpenClaw

Tambahkan provider custom OpenAI-compatible ke konfigurasi OpenClaw. Contoh format:

{
  "models": {
    "mode": "merge",
    "providers": {
      "dkey": {
        "baseUrl": "https://dkey.my.id/v1",
        "apiKey": "dkey_API_KEY_KAMU",
        "api": "openai-completions",
        "models": [
          {"id": "dkey/deepseek-v4-flash-0731", "name": "DKEY dkey/deepseek-v4-flash-0731"}
        ]
      }
    }
  }
}

Set model OpenClaw sebagai dkey/dkey/deepseek-v4-flash-0731 hanya jika konfigurasi OpenClaw meminta format provider/model. Jika model ID sudah berisi prefix dkey/ dari katalog, jangan gandakan prefix.

OpenCode

Jalankan /connect, pilih Other, buat provider ID dkey, lalu simpan API key. Setelah itu isi opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "dkey": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "DKEY",
      "options": {
        "baseURL": "https://dkey.my.id/v1",
        "apiKey": "{env:DKEY_API_KEY}"
      },
      "models": {
        "dkey/deepseek-v4-flash-0731": {"name": "DKEY model"}
      }
    }
  },
  "model": "dkey/dkey/deepseek-v4-flash-0731"
}

export DKEY_API_KEY="dkey_API_KEY_KAMU"
opencode
# Cek model dari command /models

Untuk semua klien: model harus cocok persis dengan hasil endpoint /v1/models. Jika muncul 401, periksa API key. Jika 402, saldo kredit habis. Jika 403, cap token model terlampaui.

Kredit & batas.

Satu request sukses memotong kredit sesuai model. Request gagal tidak dipotong. Retry internal tidak menagih dua kali.

Paket	Kredit	Berlaku	Harga
D-Promo	1.000 kredit	30 hari	Rp0
D-One	2.000 kredit	14 hari	Rp9.900
D-Two	5.000 kredit	30 hari	Rp19.000
D-Best	10.000 kredit	30 hari	Rp29.000

Saldo paket baru dan lama terpisah. Request memakai kredit yang paling cepat kedaluwarsa.
Kredit yang belum terpakai hangus saat masa paket berakhir. Tidak ada batas harian.
Cap token berlaku per request: Hemat 50.000/1.000, Standar 100.000/2.000, Premium 200.000/3.500 input/output.

Error.

Kode	Arti	Tindakan
`401`	API key tidak valid	Periksa header dan key aktif.
`402`	Kredit habis	Beli paket baru.
`403`	Cap token terlampaui	Kurangi input/output token atau pilih tier lebih tinggi.
`429`	Layanan sedang sibuk	Coba lagi beberapa saat.
`5xx`	Gangguan layanan	Coba lagi; kredit tidak dipotong.

Jika cap terlampaui, saldo tidak dipotong. Notifikasi dikirim untuk cap terlampaui, saldo habis, atau semua layanan model gagal.

FAQ.

Apakah API kompatibel dengan OpenAI?

Ya. Ubah base URL ke https://dkey.my.id/v1, gunakan API key DKEY, lalu pilih model dengan nama dkey/....

Apakah nama provider internal terlihat?

Tidak. Response, katalog, dan error hanya memakai informasi publik DKEY.

Apakah request gagal tetap mengurangi kredit?

Tidak. Hanya request yang berhasil yang memotong kredit.

Di mana lihat pemakaian?

Buka Dashboard untuk saldo dan API key. Buka Riwayat untuk model, tier, mutasi kredit, saldo, kode response, dan waktu WIB.