Klucze i adres API
MarkdownGdzie uzyskać klucz, jaki adres podać w różnych SDK i jak przekazywać klucz.
Pełny przewodnik
Klucz API
Klucz tworzy się w panelu na ailoot.ai po rejestracji. Ma postać sk-…. Możesz utworzyć kilka kluczy: osobny dla komputera służbowego, serwera i każdej aplikacji — łatwiej wtedy unieważnić jeden bez zmiany pozostałych.
Dla klucza można ustawić całkowity limit wydatków, termin ważności, listy dozwolonych i zablokowanych adresów IP oraz limity wydatków w oknach 5 godzin, 1 dzień i 7 dni. Po zadziałaniu ograniczenia otrzymasz czytelny błąd: api_key_quota_exhausted (wyczerpano całkowity limit), usage_limit_reached (wyczerpano limit wydatków klucza w oknie czasowym — poczekaj na odnowienie okna lub zwiększ limit), api_key_expired lub permission_denied (na przykład żądanie z niedozwolonego IP).
Adres API
Główna zasada: dla klientów zgodnych z OpenAI adres zawiera /v1, a dla Anthropic i Gemini — bez tego sufiksu.
| Klient | Adres bazowy | Dokąd trafia żądanie |
|---|---|---|
| OpenAI SDK i zgodne z nim aplikacje klienckie | 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 |
| Klient wymaga pełnego adresu | https://api.ailoot.ai/v1/chat/completions | zgodnie z podanym adresem |
Jak przekazywać klucz
Ailoot przyjmuje klucz w dowolnym z trzech nagłówków — użyj tego, który wysyła Twoje SDK:
| Nagłówek | Który klient go wysyła |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, większość klientów |
x-api-key: sk-… | Anthropic SDK, Claude Code z ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Na ścieżkach /v1/… klucz w adresie (?key= lub ?api_key=) nie jest przyjmowany: żądanie otrzyma 400 z kodem invalid_request i komunikatem, że klucz przekazano w adresie. Dzięki temu klucz nie trafia do logów ani historii przeglądarki. Jeśli klucz pojawił się już w adresie, najlepiej utworzyć nowy.
Na ścieżkach Gemini /v1beta/… dla zgodności z Google przyjmowane jest ?key= — z najniższym priorytetem, po nagłówkach. ?api_key= jest tam również odrzucane z 400. Nadal pewniej jest przekazywać klucz w nagłówku x-goog-api-key.
Zmienne środowiskowe
Warto utworzyć jedną zmienną i używać jej w ustawieniach różnych programów:
# ~/.zshrc lub ~/.bashrc
export AILOOT_API_KEY="sk-..."
# dla programów odczytujących standardowe nazwy
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-..."
# dla programów odczytujących standardowe nazwy
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-..."
# uruchom terminal ponownie, aby zmienne zostały wczytaneSprawdzenie klucza
Najtańszy sposób sprawdzenia klucza to pobranie listy modeli: jest bezpłatne.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"