Dokumentasi API

Mulai cepat

Pasang otomatis

Autentikasi

Authorization: Bearer hx_xxxxxxxxxxxxxxxxxxxx
x-api-key: hx_xxxxxxxxxxxxxxxxxxxx   # alternatif

Daftar model

curl https://heraxles.dev/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat completions

POST /v1/chat/completions

Contoh request

curl https://heraxles.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [
      {"role": "system", "content": "Jawab singkat dalam Bahasa Indonesia."},
      {"role": "user", "content": "Jelaskan apa itu API dalam 2 kalimat."}
    ],
    "max_tokens": 300,
    "stream": true
  }'

Bentuk jawaban

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-6-astra",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 42, "completion_tokens": 128, "total_tokens": 170}
}

Streaming

data: {"choices":[{"delta":{"content":"Se"}}]}
data: {"choices":[{"delta":{"content":"buah"}}]}
data: {"choices":[{"delta":{},"finish_reason":"stop"}],
       "usage":{"total_tokens":170}}
data: [DONE]

Function calling

{
  "model": "gpt-6-astra",
  "messages": [{"role": "user", "content": "Cuaca Jakarta?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Ambil cuaca sebuah kota",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  }]
}

/v1/responses

curl https://heraxles.dev/v1/responses \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","input":"Halo","stream":true}'

Endpoint dashboard & bridge

Setelan per alat

Cek kuota & masa aktif

Batas & header

Batas kecepatan, paralel & paket

• Perpanjangan tier yang sama otomatis menambah akumulasi sisa masa aktif key. Pergantian ke tier berbeda langsung memakai durasi paket baru pilihan.
• Booster berlaku 24 jam per pembelian untuk menaikkan slot paralel dan RPM; perpanjangan booster tier yang sama menambah sisa jam; booster hanya aktif selama paket dasar berlaku.
• Pembelian paket lewat dasbor member langsung aktif otomatis pada API key; voucher dari luar dasbor diklaim manual melalui menu Klaim Voucher.

Slot langganan (kapasitas paket)

Slot adalah kapasitas langganan berbayar yang aktif. Satu slot berarti satu langganan aktif, bukan satu request — ini berbeda dari slot paralel (request bersamaan) di atas.

Jumlah langganan aktif dibatasi agar kapasitas server terbagi rata dan kualitas setiap paket tetap stabil.

Kalau slot penuh, pembeli baru belum bisa melanjutkan pembelian sampai ada slot yang lepas. Tidak ada daftar tunggu; halaman otomatis membuka lagi begitu slot tersedia. Member yang sudah aktif tetap berjalan normal dan tetap dapat memperpanjang paketnya.

Slot sebuah langganan kembali tersedia begitu masa aktifnya berakhir.

Buka Aturan & Ketentuan

Kode error

Praktik baik