Autentikasi

Setiap request membawa API key.

Authorization: Bearer SIVCLOUD_API_KEY

Untuk /v1/messages dan /v1/models, header x-api-key: SIVCLOUD_API_KEY juga diterima, seperti pada SDK Anthropic.

Aturan

• Kirim kunci hanya di header. Jangan taruh kunci di URL, kode di browser, atau repositori publik.
• Satu akun boleh punya banyak kunci, sampai 100 secara bawaan. Pakai satu kunci untuk satu aplikasi supaya mudah dicabut.
• Kunci yang diblokir, kedaluwarsa, atau dicabut ditolak dengan invalid_api_key (HTTP 401).
• Kunci bisa dibatasi ke model tertentu. Model di luar batas dijawab model_not_found (HTTP 404).
• Kunci yang aktif bisa Anda salin lagi dari console. Kunci yang diblokir atau kedaluwarsa tidak bisa.
• Curiga kunci bocor? Rotasi kunci di console. Kunci lama langsung mati.

Pengaturan kunci dijelaskan di halaman API key.

Cek saldo dari kunci

GET https://ai.sivcloud.com/v1/balance menjawab saldo akun pemilik kunci, tanpa membuka console.

curl https://ai.sivcloud.com/v1/balance -H "Authorization: Bearer $SIVCLOUD_API_KEY"

{
  "balance_rp": 125000,
  "key_limit_rp": null,
  "allowances": [
    {"plan": "Pro", "models": [], "remaining": 3400000, "resets_at": "2026-12-01T00:00:00+07:00"}
  ]
}

• balance_rp: saldo rupiah akun.
• key_limit_rp: sisa batas kredit kunci ini dalam rupiah, atau null bila kunci tidak dibatasi.
• allowances: jatah token paket yang sedang berlaku. plan nama paket (kosong bila tidak diketahui), remaining dalam token, models kosong berarti semua model, dan resets_at kosong bila jatah tidak kedaluwarsa.

Hanya data akun pemilik kunci yang dikembalikan.

Contoh galat

{
  "error": {
    "message": "invalid api key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Daftar lengkap ada di Kode galat.