API bảng điều khiển
MarkdownCác phương thức của trang quản lý tài khoản: đăng nhập, hồ sơ, khóa và lịch sử chi phí.
Hướng dẫn đầy đủ
Địa chỉ và xác thực
- Trang quản lý tài khoản: https://ailoot.ai (đăng nhập bằng thông tin đăng nhập, token trang quản lý tài khoản)
- API mô hình: https://api.ailoot.ai (khóa sk-…)
| Mục | Địa chỉ | Xác thực |
|---|---|---|
| API bảng điều khiển | https://ailoot.ai/api/v1 | Authorization: Bearer $TOKEN — token trang quản lý tài khoản sau khi đăng nhập |
| API mô hình | https://api.ailoot.ai/v1 | Khóa sk-… từ phần “Khóa API”; xem Khóa và địa chỉ API |
Khóa sk-… không thay thế token trang quản lý tài khoản; token trang quản lý tài khoản cũng không mở quyền truy cập API mô hình. Đường dẫn đầy đủ được ghi ở mỗi phương thức.
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
-H "Authorization: Bearer $TOKEN"Định dạng phản hồi và lỗi
Phản hồi chứa code, message và data. Lỗi có thể chứa reason và metadata. Dữ liệu phân trang trong data chứa items, total, page, page_size và pages. Định dạng của từng phương thức được ghi trong mô tả.
{
"code": 0,
"message": "success",
"data": {
"items": [],
"total": 0,
"page": 1,
"page_size": 20,
"pages": 1
}
}Token trang quản lý tài khoản được kiểm tra theo thời hạn hiệu lực và trạng thái hoạt động của người dùng; nếu bật ràng buộc phiên, còn kiểm tra IP và trình duyệt. Các mã TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN và FORBIDDEN phân biệt vấn đề về phiên và quyền. Giới hạn tần suất và xác nhận 2FA bổ sung có thể chặn một yêu cầu cụ thể.
Cách đọc tài liệu tham khảo
- Mỗi mục chứa phương thức HTTP, đường dẫn đầy đủ, quyền truy cập, tham số, trường nội dung yêu cầu và phản hồi.
- Lấy mã định danh từ phản hồi trước đó: KEY_ID — từ GET /api/v1/keys, ID yêu cầu — từ GET /api/v1/usage.
- Các trường của đối tượng và kiểu dữ liệu tương ứng nằm trên trang “Lược đồ dữ liệu”.
- Các mẫu hiển thị tên và kiểu dữ liệu của trường. PLACEHOLDER và TOKEN là các dấu đánh dấu, không có dữ liệu thật ở đây.
- Nạp số dư trong phần “Gói cước” của trang quản lý tài khoản: cách nạp tiền.
Số dư và frozen_balance
Hồ sơ chứa balance và frozen_balance. frozen_balance là số tiền được giữ trước cho các yêu cầu chưa hoàn thành. Hãy kiểm tra cả hai trường cùng với lịch sử.
Khóa và giới hạn
GET /api/v1/keys trả về các khóa của bạn. Các trường quota và quota_used — giới hạn chi tiêu của khóa và phần đã sử dụng; ip_whitelist, ip_blacklist, status và expires_at điều khiển việc sử dụng khóa; rate_limit_5h, rate_limit_1d và rate_limit_7d — giới hạn chi tiêu theo khoảng thời gian.
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
-H "Authorization: Bearer $TOKEN"
# KEY_ID là id của khóa thuộc sở hữu của bạn trong phản hồi danh sách
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
-H "Authorization: Bearer $TOKEN"Chi phí và bảo mật
Lịch sử và dashboard hiển thị actual_cost — số tiền trừ thực tế; total_cost — chi phí theo giá tiêu chuẩn. Bộ lọc ngày, mô hình, khóa và loại yêu cầu được ghi ở phương thức. Đổi mật khẩu, TOTP và passkey cần các xác nhận được mô tả ở phương thức tương ứng.
Trong phần này: 39 phương thức.