Dokumentasi

Panduan integrasi

Gunakan API key dengan format dan base URL sesuai kebutuhan. Generate gambar memakai base URL khusus yang dapat berbeda dari gateway teks.

Cara nyambungin per platform

26 platform

Pilih editor, CLI, aplikasi chat/roleplay, workflow otomasi, atau bahasa pemrograman yang kamu pakai — lengkap dengan Base URL siap salin.

Panduan VS Code

Siap pakai

Cline, Roo Code, Kilo Code, Continue, Copilot

Base URL (OpenAI Compatible)
https://advancebyte.biz.id/v1
1Buka VS Code → Extensions (Ctrl+Shift+X), pasang Cline, Roo Code, atau Kilo Code.
2Buka ikon ekstensi di sidebar kiri → klik ikon roda gigi (Settings ⚙️).
3Pada API Provider, pilih OpenAI Compatible.
4Isi Base URL dengan https://advancebyte.biz.id/v1 dan API Key dengan key adv-... dari Dashboard.
5Pilih Model ID dari daftar otomatis (mis. adgent-code) atau ketik dari halaman /model, lalu klik Save / Done.
Isian Cline / Roo Code / Kilo Code
API Provider : OpenAI Compatible Base URL : https://advancebyte.biz.id/v1 API Key : adv-xxxxxxxxxxxxxxxxxxxx Model ID : adgent-code
Tips: Jika kamu membatasi daftar model pada API key di Dashboard, ekstensi VS Code otomatis hanya menampilkan model yang kamu izinkan.

Base URL

Pilih alamat sesuai format yang digunakan. API gambar dilayani melalui domain website dan bisa berbeda dari gateway teks; jangan menukar base URL keduanya tanpa memeriksa konfigurasi.

GayaBase URL yang bisa dipakai
OpenAI (teks)https://advancebyte.biz.id/v1
Generate gambarhttps://advancebyte.biz.id/v1
OpenAI (lengkap)https://advancebyte.biz.id/api/openai/v1
Claudehttps://advancebyte.biz.id/claude
Geminihttps://advancebyte.biz.id/v1beta
Gemini (lengkap)https://advancebyte.biz.id/api/gemini/v1beta

Untuk gambar, gunakan base URL pada baris Generate gambar. Alamat ini tidak menjamin model atau provider sudah aktif; ketersediaan bergantung pada konfigurasi layanan.

Endpoint yang didukung

EndpointDipakai olehStatus
POST /v1/chat/completionsOpenAI SDK, Cursor, Cline, Roo, Continue, LibreChatpenuh
POST /v1/images/generationsAPI gambar pada domain websiteperlu konfigurasi
POST /v1/responsesCodex CLI, OpenAI Agents SDKpenuh
POST /v1/completionstool lama (legacy text completion)penuh
POST /v1/embeddingsRAG, vector DBditeruskan
POST /v1/tokenizehitung token & biaya tanpa memotong kuotapenuh
GET /v1/modelssemua agent (deteksi model)penuh
GET /v1/mecek sisa kuota, masa aktif, batas laju dari skrippenuh
POST /v1/messagesClaude Code, Anthropic SDKpenuh
POST /v1/messages/count_tokensClaude Codepenuh
POST /v1beta/models/{model}:generateContentGoogle SDK, Gemini toolingpenuh

Cek kuota dari dalam skrip

GET /v1/me menjawab tiga hal yang biasanya harus dibuka dashboard dulu: sisa kuota, masa aktif, dan batas laju key yang sedang dipakai. Berguna untuk cron atau agent yang ingin berhenti sendiri sebelum kena penolakan.

curl https://advancebyte.biz.id/v1/me \ -H "Authorization: Bearer $ADVANCE_API_KEY"

Balasan memuat quota.limit, quota.left, validity.days_left, limits.requests_per_minute, usage_24h, dan usable (false kalau kuota habis atau masa aktif berakhir). Endpoint ini tidak memotong kuota.

Hitung biaya sebelum kirim

POST /v1/tokenize mengembalikan jumlah token dan kuota yang akan dipotong — tanpa benar-benar memanggil model dan tanpa memotong kuota. Cocok untuk membuat pagar anggaran di aplikasimu: tolak request sebelum terkirim kalau enough bernilai false.

curl https://advancebyte.biz.id/v1/tokenize \ -H "Authorization: Bearer sk-adv-xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-claude-opus-5.5", "messages": [{"role":"user","content":"Ringkas artikel ini: ..."}], "max_tokens": 400 }'

Balasan berisi tokens_input, tokens_output, quota_units, quota_left, enough, dan est_idr (perkiraan rupiah memakai tarif paket termurah). Angkanya perkiraan ±5% — angka inilah yang dipakai gateway untuk memotong kuota, jadi selalu sama dengan tagihan asli.

Autentikasi

Kirim API key lewat header sesuai format endpoint. Untuk API gambar, gunakan Authorization: Bearer.

# Untuk API gambar wajib menggunakan Authorization: Bearer Authorization: Bearer sk-adv-xxxxxxxx # Header alternatif untuk gateway teks sesuai formatnya x-api-key: sk-adv-xxxxxxxx x-goog-api-key: sk-adv-xxxxxxxx # khusus Gemini

Generate gambar lewat API

Gunakan base URL khusus gambar di aplikasi atau SDK yang mendukung OpenAI Images. Alamat ini mengikuti domain website dan dapat berbeda dari base URL gateway teks.

Base URL gambar
https://advancebyte.biz.id/v1
Endpoint lengkap · POST
https://advancebyte.biz.id/v1/images/generations

Diperlukan API key aktif, plan minimal Starter yang masih berlaku, serta model gambar dan harga yang sudah dikonfigurasi dan terverifikasi. Referensi di katalog tidak menjamin model tersedia. Setiap permintaan dapat dikenakan biaya sesuai key; periksa harga sebelum mengirim.

Harga gambar dinyatakan per gambar dalam Rupiah — tidak ada satuan token yang perlu kamu hitung. Tarif tersimpan bisa diperiksa di https://advancebyte.biz.id/v1/models pada advance.price_per_image.paygo_idr; nilai kosong berarti belum ada penawaran terverifikasi yang berlaku. Tarif dan ketersediaan diperiksa lagi saat request. Untuk menolak perubahan harga, kirim expected_source (package atau paygo) dan expected_charge sesuai nominal yang sudah kamu periksa.

Ganti MODEL_GAMBAR_AKTIF dengan ID model gambar yang tersedia dan isi variabel ADVANCE_API_KEY secara aman. Satu request hanya mendukung n: 1 dan hasil gambar berupa data[0].b64_json.

curl "https://advancebyte.biz.id/v1/images/generations" -H "Authorization: Bearer $ADVANCE_API_KEY" -H "Content-Type: application/json" -d '{"model":"MODEL_GAMBAR_AKTIF","prompt":"Pemandangan matahari terbenam","n":1,"response_format":"b64_json"}'

Jika respons terputus atau status penagihan tidak pasti, periksa riwayat pemakaian sebelum mengulangi permintaan.

OpenAI compatible

Mendukung stream, tools, response_format, dan /v1/models.

curl https://advancebyte.biz.id/v1/chat/completions \ -H "Authorization: Bearer sk-adv-xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-claude-opus-5.5", "messages": [{"role":"user","content":"Halo!"}], "stream": true }'
from openai import OpenAI client = OpenAI( base_url="https://advancebyte.biz.id/v1", api_key="sk-adv-xxxxxxxx", ) stream = client.chat.completions.create( model="gpt-claude-opus-5.5", messages=[{"role": "user", "content": "Halo!"}], stream=True, ) for chunk in stream: print(chunk.choices[0].delta.content or "", end="")

Claude compatible

Format /v1/messages termasuk system, max_tokens, tool use, dan event SSE content_block_delta.

curl https://advancebyte.biz.id/claude/v1/messages \ -H "x-api-key: sk-adv-xxxxxxxx" \ -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!"}] }'
import anthropic client = anthropic.Anthropic( base_url="https://advancebyte.biz.id/claude", api_key="sk-adv-xxxxxxxx", ) msg = client.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Halo!"}], ) print(msg.content[0].text)

Gemini compatible

Gunakan :generateContent atau :streamGenerateContent. Nama model ditulis di path.

curl "https://advancebyte.biz.id/v1beta/models/gpt-kimi-k2.8:generateContent" \ -H "x-goog-api-key: sk-adv-xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "contents": [{"parts":[{"text":"Halo!"}]}] }'

Alias model

Nama asli selalu menang. Untuk model non-gpt-, tersedia alias berawalan gpt- — berguna untuk aplikasi yang hanya menerima nama model GPT.

DimintaDiarahkan kePengali
gpt-claude-opus-5.5claude-opus-5-532×
gpt-claude-opus-5claude-opus-520×
gpt-kimi-k2.8kimi-k2.82×
gpt-5.6gpt-5.6 (asli, tidak diubah)5×

Nama model di respons dikembalikan sesuai yang kamu minta, jadi aplikasi tidak akan melihat nama internal.

Bagaimana harga dihitung

Semua harga di situs ini sudah final dalam Rupiah. Di baliknya, tiap model punya faktor pengali dari penyedianya. Faktor itu dikalikan tarif acuan per 1 juta token, lalu dibulatkan ke atas ke rupiah utuh — hasilnya angka yang kamu lihat di katalog dan di halaman model. Faktor pengali hanya dipakai untuk perhitungan internal; kamu cukup membaca angkanya dalam Rupiah.

Rumus satu permintaan
biaya = (token_masuk  × harga_masuk  / 1.000.000)
      + (token_keluar × harga_keluar / 1.000.000)
      + dasar_per_permintaan

Contoh: model dengan harga Rp 968 per 1 juta token masuk dan Rp 1.613 per 1 juta token keluar, tanpa dasar. Permintaan 20.000 token masuk + 1.000 token keluar = Rp 19,36 → Rp 20 (dibulatkan ke atas ke rupiah utuh).

Harga token masuk dan token keluar dipisah karena penyedia menagih keduanya dengan tarif berbeda.
Sebagian model menambahkan biaya dasar sekali per permintaan. Kalau tertulis "tanpa dasar", tidak ada tambahan itu.
Yang dihitung adalah semua token yang dibaca dan dihasilkan: prompt, riwayat chat, prompt cache, reasoning, tool calling, dan jawaban.
Model keluarga agent (awalan adgent-) memilih model dasar saat permintaan berjalan. Harga mengikuti model yang dipilih dan tidak melebihi batas yang tercantum di halaman modelnya.
Respons error 5xx dari sisi kami tidak memotong saldo.

Saldo akun & batasan per API key

TPD · TPM · RPM UNLIMITED
Semua API key memakai satu saldo Rupiah akun bersama — tidak perlu membagi-bagi saldo ke tiap key.
Saat membuat atau mengedit API key di Dashboard → API Key, kamu bebas mengatur 3 pengaman opsional: Batas Pemakaian Token, Tanggal Kedaluwarsa (Expired Date), dan Daftar Model yang Diizinkan.
Saldo dipotong sesuai rumus di bagian cara perhitungan: token masuk dan keluar dihitung terpisah, ditambah biaya dasar bila modelnya punya.
TPD · TPM · RPM UNLIMITED secara bawaan: tidak ada batas harian, per menit, atau per detik kecuali kamu mengaturnya sendiri di pengaturan key.
Gangguan 5xx di sisi server tidak pernah memotong saldo kamu.

Webhook

Satu URL per akun, diatur di Dashboard → Pengaturan. Kami mengirim POST dengan JSON { event, at, data } untuk kejadian pesanan.lunas, perpanjangan.lunas, kuota.menipis (sisa ≤ 20%), dan key.kedaluwarsa.

# header yang dikirim x-advance-event: pesanan.lunas x-advance-signature: sha256=<hmac sha256 dari body mentah memakai secret-mu> # verifikasi di server-mu (node) const sig = "sha256=" + crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex"); if (sig !== req.headers["x-advance-signature"]) return res.status(401).end(); # balas 2xx dalam < 8 detik. Gagal: diulang 3x (0,5 dtk, 1,5 dtk, 4 dtk) # untuk galat jaringan dan 5xx. Balasan 4xx tidak diulang.

API key lengkap TIDAK pernah dikirim lewat webhook — payload hanya memuat id dan prefix key. Ambil key-nya di dashboard.

Kode error

401 invalid_api_key Key salah atau tidak dikirim 403 key_revoked Key dicabut 403 key_expired Melewati tanggal kedaluwarsa key (saldo akun tetap utuh) 403 model_not_allowed Model tidak termasuk dalam daftar model yang diizinkan key ini 402 key_limit_exceeded Pemakaian key mencapai batas token khusus key ini 402 insufficient_quota Saldo AdToken akun tidak cukup 404 model_not_found Model/alias tidak dikenal 429 rate_limit_exceeded Melebihi batas request/menit atau token/menit key 503 service_unavailable Maintenance (mode tolak request)

Model tersedia

adgent-code · 15×adgent-deepseek · 4×adgent-design · 10.5×adgent-flash · 3.5×adgent-gemini · 65×adgent-glm · 4×adgent-gpt · 15×adgent-kimi · 7×adgent-mimo · 3×adgent-mini · 2×adgent-minimax · 6×adgent-nemotron · 5×lihat semua →

Belum punya key?

Mulai dari Rp 26.000, aktif otomatis setelah bayar.

Isi saldo