✓ Tersalin ke clipboard!
BILOOU
MASUK • DAFTAR
📖 DAFTAR ISI ▼

Dokumentasi API Gateway

BILOOU API Gateway mengadopsi Standar Kompatibilitas OpenAI secara penuh. Artinya, semua aplikasi yang mendukung "OpenAI-compatible API" bisa langsung terhubung tanpa konfigurasi tambahan.

Dengan satu API Key dan satu endpoint, Anda mendapatkan akses ke berbagai model AI terkemuka dari penyedia berbeda:

  • Anthropic Claude (Opus, Sonnet, Haiku) — Model reasoning dan analisis terbaik, dijalankan melalui AWS Bedrock
  • Deepseek & Qwen — Model coding, penalaran chain-of-thought, dan efisiensi tinggi yang sangat kuat
  • OpenAI (GPT-4o, GPT-4 Turbo, GPT-3.5) — Model flagship ekosistem OpenAI
💡 Penting: Semua model text/chat mendukung True Streaming (SSE). Response mengalir secara real-time token demi token — sama cepatnya seperti mengakses provider langsung. Cocok untuk IDE, chatbot, dan aplikasi yang membutuhkan respons instan.

1. Autentikasi

Semua request API memerlukan autentikasi. Sertakan API Key Anda di HTTP Header menggunakan skema Bearer Token:

Authorization: Bearer YOUR_API_KEY_HERE

API Key Anda bisa ditemukan di halaman Dashboard setelah login.

⚠️ Peringatan Keamanan: Jaga kerahasiaan API Key Anda. Siapa pun yang memiliki Key ini dapat menggunakan saldo token Anda. Jangan pernah membagikan API Key di repository publik, forum, atau chat grup.

2. Integrasi ke Tools & IDE (Plug & Play)

Karena BILOOU mengikuti standar OpenAI sepenuhnya, Anda bisa langsung menyambungkannya ke berbagai aplikasi tanpa modifikasi apapun:

  • IDE & Coding Assistant: VS Code + Continue, VS Code + Cline, Cursor, Windsurf, Roo Code, Codex CLI
  • Chat Interface: ChatboxAI, TypingMind, OpenWebUI, LibreChat, BoltAI
  • Router & Aggregator: 9Router, OpenRouter-compatible apps
  • Automation: n8n, Langchain, Flowise, atau custom app via REST API

Konfigurasi umum yang dibutuhkan:

  • Provider / API Type: Pilih "OpenAI" atau "OpenAI Compatible" atau "Custom Endpoint"
  • Base URL: https://biloou.com/v1 (Jika diminta Full URL Chat: https://biloou.com/v1/chat/completions)
  • API Key: YOUR_API_KEY_HERE
  • Model ID: Pilih dari daftar otomatis, atau input manual dari daftar di bawah.

3. Daftar Model Lengkap

Berikut semua model AI yang tersedia. Untuk daftar harga, silakan merujuk ke halaman Pricing.

Anthropic Claude

Model ID Deskripsi
Claude Opus 4.6 us.anthropic.claude-opus-4-6-v1 Model paling canggih untuk tugas kompleks, analisis mendalam, dan coding tingkat lanjut.
Claude Sonnet 4.6 us.anthropic.claude-sonnet-4-6 Keseimbangan sempurna antara kecerdasan dan kecepatan, ideal untuk tugas sehari-hari.
Claude Opus 4.5 us.anthropic.claude-opus-4-5-20251101-v1:0 Versi stabil Claude Opus dengan performa tinggi.
Claude Haiku 4.5 us.anthropic.claude-haiku-4-5-20251001-v1:0 Respons tercepat dengan biaya paling ekonomis, cocok untuk tugas sederhana.

Deepseek & Qwen

Model ID Deskripsi
Deepseek V3.2 deepseek.v3.2 Model coding dan reasoning yang sangat kuat dengan konteks 128K.
Deepseek R1 deepseek.r1-v1:0 Model reasoning dengan kemampuan chain-of-thought untuk problem solving kompleks.
Qwen 3 Coder Next qwen.qwen3-coder-next Spesialis coding dan programming dengan dukungan multi-bahasa pemrograman.
Qwen 3 Next (80B) qwen.qwen3-next-80b-a3b Model general purpose 80B parameter dengan performa tinggi.
Qwen 3 VL (235B) qwen.qwen3-vl-235b-a22b Model vision-language untuk analisis gambar dan teks (multimodal).

OpenAI

Model ID Deskripsi
GPT-4o gpt-4o Model flagship OpenAI dengan kemampuan multimodal terbaik.
GPT-4o Mini gpt-4o-mini Versi ringkas GPT-4o dengan biaya lebih rendah.
GPT-4 Turbo gpt-4-turbo Model powerful dengan konteks 128K.
GPT-3.5 Turbo gpt-3.5-turbo Model cepat dan ekonomis untuk tugas sederhana.

4. Endpoint: Daftar Model

GET https://biloou.com/v1/models

Mengembalikan daftar semua model yang aktif. Endpoint ini digunakan oleh aplikasi klien (seperti Continue, ChatboxAI) untuk menampilkan pilihan model di dropdown secara otomatis. Tidak memerlukan autentikasi.

Contoh Response:
{ "object": "list", "data": [ { "id": "us.anthropic.claude-sonnet-4-6", "object": "model", "created": 1717800000, "owned_by": "aws-bedrock" }, { "id": "gpt-4o", "object": "model", "created": 1717800000, "owned_by": "openai" } ] }

5. Endpoint: Chat Completions

POST https://biloou.com/v1/chat/completions

Endpoint utama untuk mengirimkan prompt dan menerima respons dari AI. Mendukung mode synchronous (response utuh) dan streaming (token real-time).

Contoh Request Body (Non-Stream):
{ "model": "us.anthropic.claude-sonnet-4-6", "messages": [ { "role": "system", "content": "Anda adalah asisten AI yang membantu." }, { "role": "user", "content": "Apa itu API Gateway?" } ], "temperature": 0.7, "max_tokens": 4000 }

6. Streaming (Server-Sent Events)

Untuk menerima respons token demi token, set parameter "stream": true. Response dikirim dalam format Server-Sent Events (SSE) standar OpenAI.

Format Response Stream (SSE):
data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","model":"us.anthropic.claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":"Berikut"},"finish_reason":null}]} data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","model":"us.anthropic.claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":" fungsi"},"finish_reason":null}]} data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","model":"us.anthropic.claude-sonnet-4-6","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]} data: [DONE]

7. Parameter API Lengkap

Parameter Wajib Deskripsi
model String ✅ Ya ID model yang akan digunakan (misal: us.anthropic.claude-sonnet-4-6).
messages Array ✅ Ya Array percakapan. Setiap objek memiliki role (system/user/assistant) dan content.
stream Boolean ❌ Tidak Jika true, respons dikirim via SSE. Default: false.
temperature Float ❌ Tidak Mengontrol kreativitas (0.0 = kaku/faktual, 1.0 = kreatif). Default: 0.7.
max_tokens Integer ❌ Tidak Batas maksimum token yang dihasilkan oleh AI.

8. Contoh Kode (REST API)

Python (Requests)

import requests import json url = "https://biloou.com/v1/chat/completions" headers = { "Authorization": "Bearer YOUR_API_KEY_HERE", "Content-Type": "application/json" } data = { "model": "us.anthropic.claude-sonnet-4-6", "messages": [ {"role": "user", "content": "Buatkan fungsi Python untuk binary search."} ] } response = requests.post(url, headers=headers, json=data) print(json.dumps(response.json(), indent=2))

JavaScript (Node.js / Fetch)

const response = await fetch("https://biloou.com/v1/chat/completions", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY_HERE", "Content-Type": "application/json" }, body: JSON.stringify({ model: "us.anthropic.claude-sonnet-4-6", messages: [{ role: "user", content: "Jelaskan konsep async/await." }] }) }); const data = await response.json(); console.log(data.choices[0].message.content);

9. Penanganan Error

API mengembalikan kode HTTP standar beserta pesan error dalam format JSON jika terjadi kendala:

Kode HTTP Deskripsi
200 ✅ Sukses — Request berhasil diproses.
400 ❌ Bad Request — JSON tidak valid, atau parameter kurang/salah.
401 ❌ Unauthorized — API Key tidak valid atau tidak disertakan.
403 ❌ Forbidden — Saldo token habis. Silakan top-up.
500 ❌ Internal Server Error — Kesalahan server atau provider upstream.
Contoh Response Error:
{ "error": { "message": "Saldo token habis. Silakan lakukan top-up pada dashboard untuk melanjutkan.", "type": "api_error", "code": 403 } }