API πίνακα ελέγχου

• Πίνακας ελέγχου: https://ailoot.ai (σύνδεση στον λογαριασμό, token πίνακα ελέγχου)
• API μοντέλων: https://api.ailoot.ai (κλειδί sk-…)

Κλειδί sk-… δεν αντικαθιστά το token του πίνακα ελέγχου, ενώ το token του πίνακα ελέγχου δεν παρέχει πρόσβαση στο API μοντέλων. Η πλήρης διαδρομή αναφέρεται σε κάθε μέθοδο.

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

Η απάντηση περιέχει code, message και data. Ένα σφάλμα μπορεί να περιέχει reason και metadata. Η σελιδοποίηση στο data περιέχει items, total, page, page_size και pages. Η μορφή κάθε μεθόδου αναφέρεται στην περιγραφή της.

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

Το token του πίνακα ελέγχου ελέγχεται ως προς τη λήξη του και το αν ο χρήστης είναι ενεργός· αν είναι ενεργή η δέσμευση συνεδρίας, ελέγχονται επίσης η IP και το πρόγραμμα περιήγησης. Οι κωδικοί TOKEN_EXPIRED, TOKEN_REVOKED, USER_INACTIVE, INVALID_TOKEN και FORBIDDEN διακρίνουν προβλήματα συνεδρίας και δικαιωμάτων. Το όριο συχνότητας και η πρόσθετη επαλήθευση 2FA μπορούν να αποκλείσουν ένα συγκεκριμένο αίτημα.

• Κάθε καταχώριση περιέχει τη μέθοδο HTTP, την πλήρη διαδρομή, την πρόσβαση, τις παραμέτρους, τα πεδία σώματος και την απάντηση.
• Πάρτε τα αναγνωριστικά από την προηγούμενη απάντηση: KEY_ID — από GET /api/v1/keys, ID αιτήματος — από GET /api/v1/usage.
• Τα πεδία αντικειμένων και οι τύποι τους βρίσκονται στις σελίδες «Σχήματα δεδομένων».
• Τα πρότυπα δείχνουν τα ονόματα και τους τύπους των πεδίων. Τα PLACEHOLDER και TOKEN είναι δείκτες· δεν υπάρχουν πραγματικά δεδομένα εδώ.
• Η ανανέωση υπολοίπου βρίσκεται στην ενότητα «Τιμολόγηση» του πίνακα ελέγχου: πώς να ανανεώσετε το υπόλοιπο.

Το προφίλ περιέχει balance και frozen_balance. Το frozen_balance είναι το ποσό που έχει δεσμευτεί για μη ολοκληρωμένα αιτήματα. Ελέγξτε και τα δύο πεδία μαζί με το ιστορικό.

Το GET /api/v1/keys επιστρέφει τα κλειδιά σας. Τα πεδία quota και quota_used — το όριο δαπανών του κλειδιού και το ποσό που έχει ήδη δαπανηθεί· ip_whitelist, ip_blacklist, status και expires_at ελέγχουν τη χρήση του κλειδιού· rate_limit_5h, rate_limit_1d και rate_limit_7d — όρια δαπανών ανά χρονικό παράθυρο.

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

# KEY_ID — το id του δικού σας κλειδιού από την απάντηση της λίστας
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"

Το ιστορικό και ο πίνακας ελέγχου εμφανίζουν actual_cost — την πραγματική χρέωση· total_cost — το κόστος στην κανονική τιμή. Τα φίλτρα ημερομηνίας, μοντέλου, κλειδιού και τύπου αιτήματος αναφέρονται στη μέθοδο. Η αλλαγή κωδικού πρόσβασης, το TOTP και το passkey απαιτούν τις επιβεβαιώσεις που περιγράφονται στις αντίστοιχες μεθόδους.

Σε αυτή την ενότητα: 39 μέθοδοι.