Integrasikan Brainiall ke aplikasi Python atau Node.js Anda

API Brainiall kompatibel dengan OpenAI

Jika Anda sudah tahu cara membuat request ke API OpenAI, Anda sudah tahu cara menggunakan Brainiall. Hanya 2 hal yang berubah:

1. Base URL: https://api.brainiall.com/v1 (bukan https://api.openai.com/v1)
2. API Key: format brnl-... (bukan sk-...)

Semua yang lain identik. Kode Anda yang sudah ada berfungsi hanya dengan mengganti dua nilai tersebut.

Langkah 1: buat API key Anda

1. Akses https://app.brainiall.com
2. Login dengan Google (jika pertama kali)
3. Menu → API Keys → "Buat baru"
4. Beri nama yang deskriptif ("my-app-prod" atau sejenisnya)
5. Salin key-nya — hanya muncul sekali, simpan dengan baik

Plan Pro mencakup 1 key aktif; Business mencakup kredit + beberapa key + rotasi.

Langkah 2: Python dengan httpx

`python
import httpx

BASE = "https://api.brainiall.com/v1"
KEY = "brnl-d13..." # key Anda

def chat(prompt, model="claude-sonnet-4-6"):
r = httpx.post(
f"{BASE}/chat/completions",
json={
"model": model,
"messages": [{"role": "user", "content": prompt}]
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60
)
r.raise_for_status()
return r.json()["choices"][0]["message"]["content"]

print(chat("Jelaskan TLS dalam 2 kalimat."))
`

Langkah 3: Python dengan SDK resmi OpenAI

`python
from openai import OpenAI

client = OpenAI(
base_url="https://api.brainiall.com/v1",
api_key="brnl-xxx"
)

r = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Halo!"}]
)
print(r.choices[0].message.content)
`

SDK OpenAI berfungsi 100% — kami mendukung streaming, function calling, tool_use, vision, dan semua standar OpenAI.

Langkah 4: Node.js

`javascript
import OpenAI from 'openai';

const client = new OpenAI({
baseURL: 'https://api.brainiall.com/v1',
apiKey: 'brnl-xxx'
});

const r = await client.chat.completions.create({
model: 'claude-sonnet-4-6',
messages: [{ role: 'user', content: 'Halo!' }]
});
console.log(r.choices[0].message.content);
`

Model yang tersedia

Gunakan endpoint /v1/models untuk melihat daftar secara real-time:

`python
r = httpx.get(f"{BASE}/models", headers={"Authorization": f"Bearer {KEY}"})
for m in r.json()["data"]:
print(m["id"])
`

Kategori:
- Text: claude-sonnet-4-6, gpt-5, gemini-3-pro, llama-4-maverick, deepseek-v3, dll.
- Image: gemini-3-flash-image, gpt-5-image, flux-2-klein, seedream-4.5
- Video (endpoint terpisah /v1/videos): bytedance/seedance-2.0-fast
- TTS (endpoint /v1/audio/speech): 54 suara
- STT (endpoint /v1/audio/transcriptions): Whisper Large v3

Streaming (server-sent events)

`python
with httpx.stream("POST", f"{BASE}/chat/completions", ...
json={"model": "...", "messages": [...], "stream": True}
) as r:
for line in r.iter_lines():
if line.startswith("data: "):
# parse chunk JSON
...
`

Streaming mengurangi latensi yang dirasakan secara drastis — token muncul seiring proses generasi, bukan menunggu respons lengkap.

Rate limit dan praktik terbaik

• Free tier API: tidak tersedia — API memerlukan plan Pro atau Business
• Pro: mencakup chat + image via portal, API berbayar per penggunaan
• Business: sudah termasuk kredit API senilai $50/bulan
• Retry: gunakan exponential backoff untuk error 429/5xx
• Cache: simpan respons yang bersifat deterministik secara lokal
• Timeout: 60 detik sudah aman; untuk tugas panjang seperti video, gunakan 300 detik

Kesalahan umum yang perlu dihindari

• Lupa menambahkan Bearer sebelum key → error 401
• Hardcoding key di dalam kode → berpotensi bocor saat git push; gunakan env vars
• Tidak menangani error 429 → aplikasi berhenti
• Mengabaikan usage di respons → tagihan mengejutkan
• Menggunakan model yang terlalu besar untuk tugas sederhana → biaya 10x lebih mahal dari yang diperlukan

Coba sekarang juga

Buat key Anda di https://app.brainiall.com dan jalankan salah satu contoh di atas. Plan Pro adalah minimum untuk mengakses API; Business sudah mencakup kredit yang cukup untuk memulai.