Infero
console — api reference

Panduan API Infero.

Infero menyediakan satu endpoint OpenAI-compatible (dan jalur Anthropic) yang menyatukan banyak model frontier di balik satu API key. Cukup ganti base_url & api_key — kode yang sudah ada tetap jalan.

Base URLhttps://api.infero.sbs/v1
FormatOpenAI Chat Completions
AuthBearer token
1 · mulai cepat

Quickstart

Tiga langkah untuk request pertama:

1
Ambil API key

Buka menu API Keys, buat key baru. Simpan di tempat aman — key hanya tampil sekali.

2
Pilih model

Cek daftar Models atau GET /v1/models. Pakai ID bare dari respons — tanpa prefix provider.

3
Kirim request

Panggil endpoint di bawah dengan header Authorization.

curl https://api.infero.sbs/v1/chat/completions \
  -H "Authorization: Bearer $INFERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Halo, siapa kamu?"}
    ]
  }'
2 · keamanan

Autentikasi

Sertakan API key di setiap request lewat header Authorization:

Authorization: Bearer YOUR_API_KEY
Jangan bagikan key. Key identik dengan identitas akun kamu. Semua pemakaian (dan biaya) tercatat di key tersebut. Kalau key bocor, hapus dan buat ulang dari menu API Keys.
3 · katalog

Model

Ambil daftar model yang tersedia untuk akunmu:

curl https://api.infero.sbs/v1/models \
  -H "Authorization: Bearer $INFERO_API_KEY"

Respons berisi array data[].id. Gunakan nilai id apa adanya sebagai field model di request. Nama model selalu bentuk bare (contoh: deepseek-v4.1-flash, gpt-6.1-sol, claude-opus-5-5) — jangan tambahkan prefix provider.

Model bisa berubah. Katalog bertambah seiring waktu. Selalu ambil daftar terbaru dari /v1/models atau halaman Models alih-alih meng-hardcode.
4 · inti

Chat Completions

Endpoint utama. Body mengikuti spesifikasi OpenAI Chat Completions.

POST/v1/chat/completions
FieldTipeWajibKeterangan
modelstringyaID model bare dari /v1/models.
messagesarrayyaDaftar pesan {role, content}. Role: system, user, assistant.
streambooleantidaktrue untuk respons streaming (SSE). Default false.
max_tokensintegertidakBatas token output.
temperaturenumbertidak0–2. Default 1.
toolsarraytidakFunction/tool calling (OpenAI format).

Contoh

curl https://api.infero.sbs/v1/chat/completions \
  -H "Authorization: Bearer $INFERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Halo, siapa kamu?"}
    ]
  }'
5 · realtime

Streaming

Untuk respons bertahap (token demi token), set "stream": true. Server mengirim event text/event-stream diakhiri baris data: [DONE].

curl https://api.infero.sbs/v1/chat/completions \
  -H "Authorization: Bearer $INFERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Tulis puisi pendek"}],
    "stream": true
  }'
Disarankan untuk jawaban panjang. Streaming menjaga koneksi tetap hidup pada generasi panjang dan menurunkan risiko timeout di sisi klien/proxy.
6 · kompatibel claude

Anthropic Messages

Selain format OpenAI, tersedia jalur kompatibel Anthropic untuk klien yang memakai /v1/messages.

POST/v1/messages
curl https://api.infero.sbs/v1/messages \
  -H "x-api-key: $INFERO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Halo"}]
  }'
7 · tangani kegagalan

Error & Status

StatusArtiYang dilakukan
200Sukses—
401Key tidak validCek header Authorization & key aktif di menu API Keys.
402Saldo habisIsi paket token lewat Paket Token lalu konfirmasi di Chat Admin.
404Endpoint / model salahCek URL dan ID model (/v1/models).
429Rate limitBeri jeda lalu ulangi; layanan upstream dapat membatasi request.
5xxGangguan sementaraUlangi beberapa saat lagi; hubungi Chat Admin jika berulang.
8 — akuntansi

Saldo & Token

Saldo token terpotong otomatis sesuai pemakaian setiap request. Angka di dashboard memakai satuan token tampilan.

  • Total Token Terpakai = Token Input (tidak termasuk cache) + Token Cache + Token Output.
  • Token Cache adalah bagian dari input yang dibaca dari cache (lebih murah) — bukan tambahan terpisah.
  • Penggunaan Historis (Rp) = harga normal sebelum diskon, sebagai acuan nilai pemakaian.
Isi saldo. Pilih paket di Paket Token, kirim bukti pembayaran via Chat Admin. Saldo aktif setelah admin verifikasi.
9 — catatan model

Multiple & Konteks

Tiap model punya pengali (multiple) dan jendela konteks berbeda. Angka Token Terpakai di dashboard sudah memperhitungkan pengali tersebut, sehingga berbeda dari jumlah token mentah dari API.

  • Model dengan multiple besar (mis. keluarga claude-opus/gpt-6) memotong saldo lebih cepat per token.
  • Model dengan konteks besar menaikkan kurang-lebih multiple ketika prompt melampaui ambang konteks.
  • Token cache tetap dihitung untuk akuntansi, namun dengan tarif baca lebih rendah.
Detail pengali & konteks per model tampil di halaman Models.
10 — lain-lain

FAQ

Apakah endpoint-nya benar-benar OpenAI-compatible?

Ya. Ganti base_url ke https://api.infero.sbs/v1 dan api_key ke key Infero — SDK OpenAI resmi (Python/Node) langsung bekerja.

Kenapa saya harus pakai ID model bare?

ID bare adalah nama publik model. Prefix provider (internal) tidak boleh dipakai dan akan ditolak; selalu ambil nama dari /v1/models.

Bagaimana cara mengecek sisa saldo?

Lihat menu Usage di console — saldo, pemakaian per model, dan aktivitas terbaru.

Apakah ada rate limit?

Tergantung model upstream. Bila menerima 429, ulangi dengan jeda; untuk asisten volume tinggi hubungi Chat Admin.