Mulai Cepat
Dari membeli paket sampai request pertama yang berhasil.
OAO AI Gateway adalah API kompatibel OpenAI untuk memakai banyak model AI lewat satu API key. Kamu membeli paket lewat bot Telegram, key diterbitkan otomatis, lalu key itu dipakai di aplikasi apa pun yang mendukung format OpenAI.
Tidak ada yang perlu dipasang, dashboard pun tidak wajib. Satu key berlaku untuk API, dashboard, dan contoh di halaman ini.
Semua request menuju satu base URL. Tidak ada host khusus per penyedia.
| Variabel | Nilai |
|---|---|
BASE_URL | https://oao.ai.id |
API_KEY | Key yang dikirim bot setelah pembelian. Diawali oao-store-. |
Tiga endpoint aktif, semuanya memakai key yang sama:
| Endpoint | Format |
|---|---|
/v1/chat/completions | OpenAI Chat Completions. Mendukung stream: true. |
/v1/messages | Native Anthropic Messages. Cocok untuk SDK Anthropic dan klien Claude. |
/v1/responses | Native OpenAI Responses, dikonversi otomatis di gateway. Stream memakai event response.*. |
Untuk router dan agent: isi base URL tanpa path endpoint. Router menambahkan path-nya sendiri.
Kirim key di header Authorization pada setiap request:
Authorization: Bearer oao-store-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXUntuk /v1/messages, header x-api-key juga diterima (gaya SDK Anthropic).
Key adalah satu-satunya kredensial. Dia dikirim sekali, jadi simpan dengan aman. Setelah itu tidak bisa dilihat utuh lagi, tapi bisa dibuka ulang lewat dashboard atau di-revoke lalu terbitkan yang baru.
Request paling ringkas dengan curl:
curl https://oao.ai.id/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer oao-store-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{
"model": "glm-5.3",
"messages": [{ "role": "user", "content": "Halo" }]
}'Untuk streaming, set "stream": true lalu baca aliran Server-Sent Events seperti format OpenAI biasa.
Format Anthropic
curl https://oao.ai.id/v1/messages \
-H "x-api-key: oao-store-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.3",
"max_tokens": 256,
"messages": [{ "role": "user", "content": "Halo" }]
}'Respons teks biasa diberi footer atribusi kecil. Respons yang sudah memuat footer tidak digandakan.
SDK apa pun yang kompatibel OpenAI bisa dipakai. Yang berubah hanya base URL dan API key.
Python
from openai import OpenAI
client = OpenAI(
base_url="https://oao.ai.id/v1",
api_key="oao-store-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
)
completion = client.chat.completions.create(
model="glm-5.3",
messages=[{"role": "user", "content": "Halo"}],
)
print(completion.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://oao.ai.id/v1",
apiKey: "oao-store-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
});
const completion = await client.chat.completions.create({
model: "glm-5.3",
messages: [{ role: "user", content: "Halo" }],
});
console.log(completion.choices[0].message.content);Model apa saja yang bisa kamu pakai, apa arti VIP, dan bagaimana kuota dihitung: Model, VIP dan paket
Menyambungkan router atau agent (9router, Cline, dan kawan-kawan): Router dan agent
Kalau ada yang gagal, kode statusnya dijelaskan di sini: Error dan batas laju

