dokumentasi
API dasbor

API dasbor

Markdown

Metode dasbor akun: login, profil, kunci, dan riwayat biaya.

Panduan lengkap

Alamat dan autentikasi

  • Dasbor: https://ailoot.ai (login akun, token dasbor)
  • API model: https://api.ailoot.ai (kunci sk-…)
AspekAlamatAutentikasi
API dasborhttps://ailoot.ai/api/v1Authorization: Bearer $TOKEN — token dasbor setelah login
API modelhttps://api.ailoot.ai/v1Kunci sk-… dari bagian “Kunci API”; lihat Kunci dan alamat API

Kunci sk-… tidak menggantikan token dasbor, dan token dasbor tidak memberikan akses ke API model. Jalur lengkap tercantum pada setiap metode.

Membaca profil sendiri
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"

Format respons dan kesalahan

Respons berisi code, message, dan data. Kesalahan dapat memuat reason dan metadata. Paginasi dalam data berisi items, total, page, page_size, dan pages. Format setiap metode dijelaskan dalam keterangannya.

Struktur respons dengan paginasi
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}

Token dasbor diperiksa masa berlakunya dan status aktif pengguna; jika pengikatan sesi diaktifkan, IP dan browser juga diperiksa. Kode TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN, dan FORBIDDEN membedakan masalah sesi dari hak akses. Batas frekuensi dan konfirmasi 2FA tambahan dapat memblokir permintaan tertentu.

Cara membaca referensi

  • Setiap entri berisi metode HTTP, jalur lengkap, akses, parameter, kolom isi permintaan, dan respons.
  • Ambil ID dari respons sebelumnya: KEY_ID dari GET /api/v1/keys, ID permintaan dari GET /api/v1/usage.
  • Kolom objek dan tipenya dijelaskan di halaman “Skema data”.
  • Templat menunjukkan nama dan tipe kolom. PLACEHOLDER dan TOKEN adalah penanda; tidak ada data nyata di sini.
  • Isi ulang saldo tersedia di bagian “Paket” dalam dasbor: cara mengisi ulang.

Saldo dan frozen_balance

Profil berisi balance dan frozen_balance. frozen_balance adalah jumlah yang ditahan untuk permintaan yang belum selesai. Periksa kedua kolom bersama riwayat.

Kunci dan batas

GET /api/v1/keys mengembalikan kunci Anda. Kolom quota dan quota_used — batas pengeluaran kunci dan jumlah yang sudah digunakan; ip_whitelist, ip_blacklist, status dan expires_at mengatur penggunaan kunci; rate_limit_5h, rate_limit_1d dan rate_limit_7d — batas pengeluaran per jendela waktu.

Daftar dan kunci milik sendiri
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID adalah id kunci Anda sendiri dari respons daftar
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Biaya dan keamanan

Riwayat dan dashboard menampilkan actual_cost — biaya yang benar-benar didebit; total_cost — biaya dengan harga standar. Filter tanggal, model, kunci, dan jenis permintaan dijelaskan pada metode. Perubahan kata sandi, TOTP, dan passkey memerlukan konfirmasi yang dijelaskan pada metode terkait.

Dalam bagian ini: 39 metode.

Masih ada pertanyaan? Kirim Request ID dan penjelasannya — kami akan membantu.Hubungi dukungan