Universal AI Gateway & Reseller Token API
Universal AI Gateway adalah gerbang API berstandar OpenAI (OpenAI-compatible REST Gateway) terpadu di DagangBot. Fitur ini memungkinkan pemilik toko, pengembang aplikasi, pengguna n8n, LangChain, maupun sistem eksternal untuk membeli saldo Top-Up di DagangBot dan memanggil puluhan model kecerdasan buatan melalui satu alamat endpoint universal yang ringkas.
Stable1. Ikhtisar & Keunggulan Utama
Banyak tim pengembang dan pelaku bisnis membutuhkan akses ke berbagai mesin komputasi AI (mencakup Chat Completions, Multimodal Vision, Image Generation, Voice STT/TTS, hingga Real-time Web Search) tanpa harus mengelola banyak tagihan kartu kredit internasional atau membuat kode integrasi yang berbeda untuk setiap penyedia.
- Endpoint Universal & Pendek: Seluruh panggilan API cukup diarahkan ke Base URL
https://dagangbot.web.id/v1(atau alias/api/v1/ai). Kompatibel langsung dengan pustaka resmi OpenAI SDK di Node.js, Python, Go, PHP, hingga alat otomasi seperti n8n dan Cursor. - Delapan Kapabilitas dalam Satu Pintu: Mendukung penuh Chat Completions (termasuk Server-Sent Events
stream: true), Vision (Image-to-Text), Text Embeddings, Image Generation, Text-to-Speech (TTS), Speech-to-Text (STT), Web Search, dan Web Fetch. - Manajemen Multi-API Key (
dgb_ai_): Buat kunci API terpisah untuk setiap proyek, aplikasi, atau klien lengkap dengan pembatasan izin kapabilitas (capability scope), batas permintaan per menit (rate-limit RPM), dan pagu kuota token mandiri. - Model Pay-As-You-Go Murni: Dapat digunakan oleh seluruh tingkatan akun selama memiliki Saldo Bonus atau Saldo Top-Up yang mencukupi.
Seluruh panggilan ke Universal AI Gateway (/v1/*) memakai Saldo Bonus terlebih dahulu sampai habis sebelum memotong Saldo Top-Up (paid_balance). Jika Saldo Bonus dan Saldo Top-Up Anda telah habis, permintaan API akan ditolak dengan kode status HTTP 402 Payment Required.
2. Daftar Endpoint Universal (/v1)
Seluruh endpoint di bawah ini menerima header autentikasi Authorization: Bearer dgb_ai_... atau X-API-Key: dgb_ai_...:
3. Panduan Langkah-demi-Langkah Penggunaan
Ikuti langkah berikut untuk mulai mengintegrasikan Universal AI Gateway ke aplikasi Anda:
Langkah 1: Mengisi Saldo Top-Up (Paid Balance)
- Masuk ke dasbor toko Anda dan buka menu Langganan & Dompet (
/app/billing). - Pilih nominal Top-Up Token dan selesaikan pembayaran melalui metode yang tersedia (QRIS, Virtual Account, atau Transfer).
- Pastikan nilai pada kartu Saldo Top-Up (Paid Balance) telah bertambah.
Langkah 2: Membuat API Key (dgb_ai_...)
- Buka menu AI & Otomasi → AI Gateway (API) (
/app/ai-gateway). - Pada tab API Keys, klik tombol Buat API Key Baru.
- Masukkan nama proyek (misalnya: Workflow n8n CS atau Aplikasi Kasir), atur batas RPM (default: 60 request/menit), dan tentukan batas kuota token jika diperlukan.
- Pilih kapabilitas yang diizinkan untuk kunci tersebut, lalu klik Buat API Key.
- Salin dan simpan kunci rahasia
dgb_ai_...yang muncul di layar. Demi keamanan, kunci penuh hanya ditampilkan satu kali saat pembuatan.
Langkah 3: Memanggil Endpoint dari Aplikasi Anda
Gunakan cuplikan kode berikut untuk menghubungkan aplikasi Anda ke Base URL https://dagangbot.web.id/v1:
curl -X POST https://dagangbot.web.id/v1/chat/completions \
-H "Authorization: Bearer dgb_ai_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "conversational-v1",
"messages": [
{"role": "system", "content": "Kamu adalah asisten bisnis yang ramah."},
{"role": "user", "content": "Tuliskan caption promosi kopi susu gula aren."}
],
"stream": false
}'Untuk pengguna OpenAI SDK di Node.js / TypeScript:
import OpenAI from "openai";
const openai = new OpenAI({
baseURL: "https://dagangbot.web.id/v1",
apiKey: process.env.DAGANGBOT_AI_KEY, // dgb_ai_...
});
const completion = await openai.chat.completions.create({
model: "conversational-v1",
messages: [{ role: "user", content: "Halo dari DagangBot AI Gateway!" }],
});4. Transparansi Perhitungan Biaya & Header Respons
Setiap panggilan yang berhasil ke endpoint /v1/* akan memotong Saldo Top-Up secara atomik dan menyertakan informasi pemotongan token langsung pada HTTP Response Header:
X-DagangBot-Charged-Tokens: Jumlah token yang didebit dari Saldo Top-Up Anda untuk panggilan tersebut.X-DagangBot-Balance-After: Sisa Saldo Top-Up (paid_balance) Anda tepat setelah panggilan selesai.X-DagangBot-Model: Identitas model dan kapabilitas yang menangani permintaan.
5. Kode Status & Pemecahan Masalah (Troubleshooting)
6. Referensi Terkait
Paket, Langganan & Billing
Pelajari perbedaan antara Saldo Top-Up (Paid Balance) dan Saldo Bonus paket langganan.
Autentikasi & Keamanan API
Standar keamanan kunci API, pembatasan laju permintaan, dan praktik terbaik penyimpanan kredensial.
Generator Artikel SEO (AI)
Gunakan mesin AI internal untuk memproduksi artikel blog teroptimasi SEO secara massal.
ASPRI AI
Asisten pribadi berbasis AI untuk membantu operasional harian pemilik toko.
