Κλειδιά και διεύθυνση API
MarkdownΠού θα βρείτε κλειδί, ποια διεύθυνση να ορίσετε στα διάφορα SDK και πώς να στείλετε το κλειδί.
Πλήρης οδηγός
Κλειδί API
Το κλειδί δημιουργείται στον πίνακα ελέγχου στο ailoot.ai μετά την εγγραφή. Έχει τη μορφή sk-…. Μπορείτε να δημιουργήσετε πολλά κλειδιά: ξεχωριστά για τον υπολογιστή εργασίας, τον διακομιστή και κάθε εφαρμογή — έτσι είναι ευκολότερο να ανακαλέσετε ένα χωρίς να επηρεάσετε τα υπόλοιπα.
Για το κλειδί μπορείτε να ορίσετε συνολικό όριο δαπανών, διάρκεια ισχύος, λίστες επιτρεπόμενων και αποκλεισμένων διευθύνσεων IP και όρια δαπανών ανά χρονικό παράθυρο 5 ωρών, 1 ημέρας και 7 ημερών. Αν ενεργοποιηθεί κάποιος περιορισμός, θα λάβετε κατανοητό σφάλμα: api_key_quota_exhausted (εξαντλήθηκε το συνολικό όριο), usage_limit_reached (εξαντλήθηκε το όριο δαπανών του χρονικού παραθύρου του κλειδιού — περιμένετε να ανανεωθεί το παράθυρο ή αυξήστε το όριο), api_key_expired ή permission_denied (για παράδειγμα, αίτημα από μη επιτρεπόμενη IP).
Διεύθυνση API
Βασικός κανόνας: για πελάτες συμβατούς με OpenAI, η διεύθυνση περιλαμβάνει /v1, ενώ για Anthropic και Gemini δεν το περιλαμβάνει.
| Πελάτης | Βασική διεύθυνση | Πού αποστέλλεται το αίτημα |
|---|---|---|
| OpenAI SDK και συμβατοί πελάτες | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| Ο πελάτης ζητά πλήρη διεύθυνση | https://api.ailoot.ai/v1/chat/completions | όπως ορίζεται |
Πώς να στείλετε το κλειδί
Το Ailoot δέχεται το κλειδί σε οποιαδήποτε από τις τρεις κεφαλίδες — αυτή που στέλνει το SDK σας είναι κατάλληλη:
| Κεφαλίδα | Ποιοι το στέλνουν έτσι |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, οι περισσότεροι πελάτες |
x-api-key: sk-… | Anthropic SDK, Claude Code με ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Στις διαδρομές /v1/… το κλειδί στη διεύθυνση (?key= ή ?api_key=) δεν γίνεται δεκτό: το αίτημα λαμβάνει 400 με κωδικό invalid_request και μήνυμα ότι το κλειδί δόθηκε στη διεύθυνση. Έτσι, το κλειδί δεν καταγράφεται στα αρχεία καταγραφής και στο ιστορικό του προγράμματος περιήγησης. Αν έχει ήδη εμφανιστεί στη διεύθυνση, είναι προτιμότερο να δημιουργήσετε νέο.
Στις διαδρομές Gemini /v1beta/… για συμβατότητα με το Google γίνεται δεκτό το ?key= — με τη χαμηλότερη προτεραιότητα, μετά τις κεφαλίδες. ?api_key= απορρίπτεται και εκεί με 400. Παραμένει πιο αξιόπιστο να στέλνετε το κλειδί στην κεφαλίδα x-goog-api-key.
Μεταβλητές περιβάλλοντος
Είναι βολικό να δημιουργήσετε μία μεταβλητή και να τη χρησιμοποιείτε στις ρυθμίσεις διαφορετικών προγραμμάτων:
# ~/.zshrc ή ~/.bashrc
export AILOOT_API_KEY="sk-..."
# για προγράμματα που διαβάζουν τα τυπικά ονόματα
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# για προγράμματα που διαβάζουν τα τυπικά ονόματα
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# επανεκκινήστε το τερματικό για να φορτωθούν οι μεταβλητέςΈλεγχος κλειδιού
Ο πιο οικονομικός τρόπος ελέγχου του κλειδιού είναι να ζητήσετε τη λίστα μοντέλων: είναι δωρεάν.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"