Dokumentasi API

Pengenalan

ARZASTORE AI Router menyediakan endpoint tunggal ke banyak model AI (Claude, DeepSeek, GLM, Grok, Qwen, dan lainnya). Routing antar penyedia dilakukan otomatis di belakang layar, jadi kamu tidak perlu mengurus banyak akun atau langganan.

Autentikasi

Setiap request wajib menyertakan API key di header Authorization. Jangan taruh key di URL atau kode frontend — simpan di environment variable.

# Benar
Authorization: Bearer sk-arzastore-xxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Salah (jangan taruh key di browser / URL)
https://router.arzastore.com/v1/chat/completions?api_key=sk-...

Mulai cepat

Request pertama, pilih bahasamu:

curl https://router.arzastore.com/v1/chat/completions \
  -H "Authorization: Bearer $ARZASTORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Jelaskan HTTP/3 dalam 3 kalimat."}
    ]
  }'

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://router.arzastore.com/v1",
    api_key="sk-arzastore-...",   # pakai os.environ
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Jelaskan HTTP/3 dalam 3 kalimat."}],
)
print(resp.choices[0].message.content)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://router.arzastore.com/v1",
  apiKey: process.env.ARZASTORE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-opus-5",
  messages: [{ role: "user", content: "Jelaskan HTTP/3 dalam 3 kalimat." }],
});
console.log(resp.choices[0].message.content);

Chat Completions

POST /v1/chat/completions

Endpoint utama untuk mengobrol dengan model. Menerima format pesan OpenAI standar.

Contoh request

{
  "model": "claude-opus-5",
  "messages": [
    {"role": "system", "content": "Kamu asisten yang ringkas."},
    {"role": "user", "content": "Apa itu edge computing?"}
  ],
  "max_tokens": 800,
  "temperature": 0.7
}

Contoh respons

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "claude-opus-5",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Edge computing adalah..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 42, "completion_tokens": 180, "total_tokens": 222}
}

Streaming

Tambahkan "stream": true untuk menerima jawaban bertahap (Server-Sent Events). Cocok untuk chatbot agar terasa responsif.

curl -N https://router.arzastore.com/v1/chat/completions \
  -H "Authorization: Bearer $ARZASTORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","stream":true,
       "messages":[{"role":"user","content":"Hitung 1-10"}]}'

# respons (potongan):
data: {"choices":[{"delta":{"content":"1,"}}]}
data: {"choices":[{"delta":{"content":" 2,"}}]}
data: [DONE]

Daftar Model

GET /v1/models

Mengembalikan semua model yang bisa kamu pakai dengan API key ini.

Daftar model tersedia

Embeddings

POST /v1/embeddings

Untuk pencarian semantik, klasifikasi, atau clustering.

curl https://router.arzastore.com/v1/embeddings \
  -H "Authorization: Bearer $ARZASTORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","input":"teks yang mau di-embed"}'

Parameter

Penanganan Error

Semua error dikembalikan dalam format JSON yang konsisten:

{
  "error": "Kuota API key kamu sudah habis. Silakan topup atau beli paket baru.",
  "code": "QUOTA_EXCEEDED",
  "hint": "Kelola langganan Anda melalui @Umarstorebot"
}

Contoh penanganan (Python)

import time
from openai import OpenAI, APIStatusError, APIConnectionError

client = OpenAI(base_url="https://router.arzastore.com/v1", api_key=KEY)

def chat(prompt, retries=3):
    for i in range(retries):
        try:
            return client.chat.completions.create(
                model="auto",
                messages=[{"role": "user", "content": prompt}],
                timeout=120,
            ).choices[0].message.content
        except APIStatusError as e:
            if e.status_code == 429:      # kuota habis / terlalu cepat
                raise RuntimeError("Kuota habis — topup dulu.")
            if e.status_code >= 500 and i < retries - 1:
                time.sleep(2 ** i)          # backoff 1s, 2s, 4s
                continue
            raise
        except APIConnectionError:
            if i < retries - 1:
                time.sleep(2 ** i)
                continue
            raise

Kode Status

Harga & Paket

Semua paket token bersifat lifetime — tidak ada tagihan bulanan. Harga di bawah diambil langsung dari sistem kami.

Daftar & beli sekarang →

Pertanyaan Umum

Apakah kompatibel dengan Cursor / Cline / Continue / Windsurf?

Ya. Semuanya mendukung format OpenAI — cukup ganti base URL ke https://router.arzastore.com/v1 dan masukkan API key.

Apa bedanya auto dengan nama model spesifik?

auto membiarkan router memilih dan mengalihkan model secara otomatis bila ada gangguan. Nama spesifik mengunci ke satu model.

Berapa lama timeout yang disarankan?

Minimal 120 detik untuk chat, dan lebih longgar lagi untuk model penalaran atau konteks sangat panjang.

Apakah kuota hangus kalau tidak dipakai?

Tidak. Kuota bersifat lifetime dan dapat dipakai kapan saja.

Bagaimana kalau API key saya bocor?

Masuk ke dashboard lalu tekan “Ganti API key”. Key lama langsung tidak berlaku.