AIStore API Docs

Panduan integrasi API.

Halaman ini menjelaskan alur pembelian API, cara memasang key, format request, pilihan model, contoh SDK, konfigurasi CLI, dan error yang paling sering muncul.

Mulai setup Lihat contoh request

Start

Alur dari order sampai API aktif

Ikuti urutan ini agar setup tidak salah: beli paket, buka Akses aktif atau detail order, pasang credentials, lalu pilih model yang sesuai.

Beli paket API

Pilih paket API dari katalog. Paket menentukan masa aktif, kuota, rate limit, dan model yang bisa dipakai.

Bayar dan tunggu delivery

Setelah pembayaran terkonfirmasi, API key muncul di Akses aktif dan detail order yang sudah selesai.

Pasang credentials

Gunakan Base URL https://api.aistore.biz.id/v1 dan header Authorization: Bearer ai-store-your-api-key. Jangan pasang key di query string atau kode frontend.

Pilih model ID

Isi field model dengan ID publik dari daftar model gateway sesuai paket yang dibeli.

Checklist

Pastikan ini sebelum mulai integrasi

Bagian ini mencegah error setup paling umum: order belum selesai, key salah tempel, model tidak termasuk paket, atau endpoint kurang tepat.

Akun lengkap

Order paid

API key hanya muncul setelah pembayaran QRIS terkonfirmasi dan delivery sudah selesai.

Akses aktif

Ambil key dari menu Akses aktif selama paket belum expired, atau dari detail order di Akun.

Key tersalin penuh

Pastikan key diawali ai-store- dan tidak ada spasi tambahan saat ditempel ke config.

Model sesuai paket

Jika model ditolak, cek daftar model pada paket atau gunakan model default yang disarankan.

API

Format koneksi dan aturan request

Endpoint mengikuti pola OpenAI-compatible. Tool atau SDK yang mendukung custom base URL dapat memakai API key dari AIStore.

Detail koneksi

Base URL: https://api.aistore.biz.id/v1
Authentication: Bearer token
Header wajib: Authorization: Bearer ai-store-your-api-key
Content-Type: application/json
Endpoint chat: /chat/completions
Endpoint model: /models

Aturan penting

Semua request API memakai HTTPS dan format JSON.
API key hanya dikirim lewat header Authorization, bukan query string.
Gunakan ID model publik dari daftar model. Jangan menambah prefix provider.
Jika tool meminta OpenAI-compatible endpoint, isi base URL dengan alamat v1 di atas.
Simpan key di environment variable atau file konfigurasi lokal yang tidak masuk Git.

Siklus key

Issued

Key dibuat otomatis setelah order API berstatus paid dan delivery selesai.

Active

Key tampil di Akses aktif dan bisa dipakai selama masa aktif paket belum habis dan kuota masih tersedia.

Limited

Request bisa ditolak jika model tidak termasuk paket, kuota habis, atau rate limit tercapai.

Expired

Key berhenti bekerja saat masa aktif habis dan tidak lagi tampil di Akses aktif. Buat order baru atau hubungi support dari akun order.

Endpoint matrix

Path	Method	Fungsi	Wajib
/chat/completions	POST	Menjalankan percakapan berbasis messages.	model, messages
/models	GET	Melihat daftar model yang bisa dikenali gateway.	Authorization header

Batas penggunaan key

Masa aktif

Key berhenti saat tanggal kedaluwarsa paket tercapai.

Kuota request

Setiap panggilan API mengurangi jatah request paket.

Kuota token

Pemakaian model ikut menghitung token input dan output.

Rate limit

Request terlalu rapat dapat menghasilkan 429 walau kuota masih ada.

Examples

Request dasar yang bisa langsung dites

Mulai dari cURL untuk validasi cepat, lalu pindahkan konfigurasi yang sama ke SDK atau CLI tool.

Chat completion

curl https://api.aistore.biz.id/v1/chat/completions \
  -H "Authorization: Bearer ai-store-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      { "role": "user", "content": "Jelaskan fungsi API ini dalam satu kalimat." }
    ],
    "stream": false
  }'

Response shape

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "API ini menghubungkan aplikasi Anda ke model AI lewat endpoint OpenAI-compatible."
      },
      "finish_reason": "stop"
    }
  ]
}

Cek daftar model

curl https://api.aistore.biz.id/v1/models \
  -H "Authorization: Bearer ai-store-your-api-key"

Security

Jaga API key dan pahami aturan pembelian

API key adalah credential aktif. Simpan dengan benar, pakai dari environment, dan cek aturan paket sebelum checkout.

Keamanan key

Simpan di server

API key hanya dipakai dari backend, server, terminal, atau tool lokal. Jangan masukkan key ke frontend, mobile bundle, URL publik, atau screenshot.

Pakai environment

Simpan key di environment variable seperti AISTORE_API_KEY atau file konfigurasi lokal yang tidak masuk Git.

Kirim lewat header

Gunakan Authorization: Bearer ai-store-your-api-key. Jangan kirim key lewat query string, form publik, atau log yang bisa dibaca orang lain.

Batasi sharing

Key mengikuti paket dan akun pembeli. Jika key terlanjur tersebar, hentikan pemakaian key itu dan hubungi support dari akun order.

Refund dan klaim API

Pembelian final

Paket API yang sudah dibeli dan aktif tidak bisa refund. Pastikan produk, durasi, model, kuota, dan kebutuhan penggunaan sudah sesuai sebelum checkout.

Akses aktif

Selama paket masih aktif, key tampil di Akses aktif beserta masa aktif dan detail delivery. Setelah expired, key tidak lagi tampil sebagai akses aktif.

Kendala valid

Jika key bermasalah saat masa aktif dan masih memenuhi syarat garansi, ajukan klaim dari Akses aktif atau detail order agar data order terisi otomatis.

Capabilities

Yang didukung oleh gateway API

Bagian ini membantu memilih integrasi yang tepat sebelum masuk ke konfigurasi tool.

Chat completions

Endpoint utama untuk prompt berbasis messages. Cocok untuk app, automation, agent, dan CLI coding tool.

OpenAI-compatible SDK

Bisa dipakai dengan client OpenAI yang mendukung custom baseURL atau base_url.

Model listing

Gunakan /models untuk mengecek model yang tersedia pada gateway dan package aktif.

Quota-aware access

Akses mengikuti masa aktif, kuota request, kuota token, rate limit, dan model yang diberikan oleh paket.

Gunakan env var

Simpan key sebagai AISTORE_API_KEY, lalu panggil dari runtime. Cara ini mengurangi risiko key ikut commit.

Mulai dari cURL

Validasi key dan endpoint lewat cURL sebelum memasang ke SDK atau tool besar. Debug jadi lebih cepat.

Pisahkan model default

Tetapkan satu model default stabil untuk workflow utama, lalu gunakan model lain hanya saat dibutuhkan.

Catat status code

Saat error, simpan status code dan response body sebelum menghubungi support. Ini mempercepat pengecekan.

Models

Model populer

Gunakan pilihan ini untuk mulai cepat. Daftar lengkap tetap tersedia lewat endpoint /models setelah API key aktif.

Rekomendasi utama

Pilihan paling aman untuk chat, reasoning, dan pekerjaan harian.

Popular

GPT 5.5

gpt-5.5

GPT 5.4

gpt-5.4

Coding & agent

Model yang umum dipakai untuk coding assistant, refactor, dan workflow agent.

Code

GPT 5.3 Codex

gpt-5.3-codex

Configuration

Contoh konfigurasi tool

Pilih tab sesuai tool, salin contoh, lalu ganti placeholder key dengan API key dari Akses aktif atau detail order.

cURL Chat

Terminal

curl https://api.aistore.biz.id/v1/chat/completions \
  -H "Authorization: Bearer ai-store-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      { "role": "system", "content": "You are a concise assistant." },
      { "role": "user", "content": "Tulis ringkasan singkat tentang API ini." }
    ]
  }'

Troubleshooting

Error umum dan cara membacanya

Jika request gagal, mulai dari status code. Hampir semua masalah berasal dari key, endpoint, model access, kuota, atau rate limit.

400

Payload tidak valid. Cek JSON, field model, dan struktur messages.

401

API key hilang, format salah, atau tidak terbaca penuh. Pastikan memakai header Bearer.

403

Key sudah expired, dicabut, atau model tidak termasuk paket yang dibeli.

404

Endpoint salah. Pastikan base URL berakhir dengan /v1 dan path memakai /chat/completions atau /models.

429

Kuota request, kuota token, atau request per minute sudah mencapai batas.

500/502

Gangguan sementara pada gateway atau upstream. Ulangi beberapa saat lagi.

Next step

Siap pakai API di tool Anda?

Beli paket API dari store, lalu buka Akses aktif untuk mengambil key, masa aktif, dan detail delivery selama paket masih aktif.

Beli paket Buka akun