API panel pengguna
MarkdownKaedah panel pengguna: log masuk, profil, kunci dan sejarah perbelanjaan.
Panduan lengkap
Alamat dan pengesahan
- Panel pengguna: https://ailoot.ai (log masuk akaun, token panel pengguna)
- API model: https://api.ailoot.ai (kunci sk-…)
| Perkara | Alamat | Pengesahan |
|---|---|---|
| API panel pengguna | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — token panel pengguna selepas log masuk |
| API model | https://api.ailoot.ai/v1 | Kunci sk-… daripada bahagian “Kunci API”; lihat Kunci dan alamat API |
Kunci sk-… tidak menggantikan token panel pengguna, dan token panel pengguna tidak memberikan akses kepada API model. Laluan penuh dinyatakan bagi setiap kaedah.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Format respons dan ralat
Respons mengandungi code, message dan data. Ralat mungkin mengandungi reason dan metadata. Penomboran halaman dalam data mengandungi items, total, page, page_size dan pages. Format setiap kaedah dinyatakan dalam penerangannya.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}Token panel pengguna diperiksa berdasarkan tempoh sahnya dan sama ada pengguna aktif; jika pengikatan sesi diaktifkan, IP dan pelayar turut diperiksa. Kod TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN dan FORBIDDEN membezakan masalah sesi dan hak akses. Had kadar dan pengesahan 2FA tambahan boleh menyekat permintaan tertentu.
Cara membaca rujukan
- Setiap entri mengandungi kaedah HTTP, laluan penuh, akses, parameter, medan badan permintaan dan respons.
- Ambil pengecam daripada respons terdahulu: KEY_ID — daripada GET /api/v1/keys, ID permintaan — daripada GET /api/v1/usage.
- Medan objek dan jenisnya terdapat pada halaman “Skema data”.
- Templat menunjukkan nama dan jenis medan. PLACEHOLDER dan TOKEN ialah penanda; tiada data sebenar di sini.
- Tambah nilai baki terdapat dalam bahagian “Pelan harga” panel pengguna: cara menambah nilai.
Baki dan frozen_balance
Profil mengandungi balance dan frozen_balance. frozen_balance ialah amaun yang dirizabkan untuk permintaan yang belum selesai. Semak kedua-dua medan bersama sejarah.
Kunci dan had
GET /api/v1/keys mengembalikan kunci anda. Medan quota dan quota_used — had perbelanjaan kunci dan bahagian yang sudah dibelanjakan; ip_whitelist, ip_blacklist, status dan expires_at mengawal penggunaan kunci; rate_limit_5h, rate_limit_1d dan rate_limit_7d — had perbelanjaan mengikut tetingkap masa.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID ialah id kunci milik anda daripada respons senarai
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Perbelanjaan dan keselamatan
Sejarah dan dashboard memaparkan actual_cost — caj sebenar; total_cost — kos pada harga standard. Penapis tarikh, model, kunci dan jenis permintaan dinyatakan pada kaedah. Pertukaran kata laluan, TOTP dan passkey memerlukan pengesahan yang diterangkan pada kaedah berkenaan.
Dalam bahagian ini: 39 kaedah.