Kulcsok és az API címe
MarkdownHol szerezhet kulcsot, milyen címet kell megadni az egyes SDK-kban, és hogyan adható át a kulcs.
Teljes útmutató
API-kulcs
A kulcs a fiókjában, az ailoot.ai oldalon, a regisztráció után hozható létre. Formátuma: sk-…. Több kulcsot is létrehozhat: külön a munkahelyi számítógéphez, a szerverhez és minden alkalmazáshoz — így egy kulcs könnyebben visszavonható a többi érintése nélkül.
A kulcsnál megadható a teljes költési keret, az érvényesség, az IP-címek engedélyezési és tiltási listája, valamint az 5 órás, 1 napos és 7 napos költési időablakok korlátai. Korlátozás esetén érthető hiba érkezik: api_key_quota_exhausted (a teljes keret kimerült), usage_limit_reached (a kulcs költési időablaka kimerült — várjon az időablak megújulásáig, vagy növelje a korlátot), api_key_expired vagy permission_denied (például nem engedélyezett IP-címről érkező kérés).
Az API címe
Alapszabály: OpenAI-kompatibilis klienseknél a cím végén szerepel a /v1, Anthropic és Gemini esetén pedig nélküle adandó meg.
| Kliens | Alapcím | A kérés célja |
|---|---|---|
| OpenAI SDK és kompatibilis kliensek | 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 |
| A kliens teljes címet kér | https://api.ailoot.ai/v1/chat/completions | a megadottak szerint |
A kulcs átadása
Az Ailoot a három fejléc bármelyikében elfogadja a kulcsot — az SDK-ja által küldött fejléc megfelelő:
| Fejléc | Ki küldi így? |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, a legtöbb kliens |
x-api-key: sk-… | Anthropic SDK, Claude Code ANTHROPIC_API_KEY használatával |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Az alábbi útvonalakon: /v1/… az URL-ben átadott kulcs (?key= vagy ?api_key=) nem fogadható el: a kérés 400-as választ kap ezzel a kóddal: invalid_request és azzal az üzenettel, hogy a kulcs az URL-ben szerepel. Így a kulcs nem kerül a naplókba és a böngészési előzményekbe. Ha a kulcs már szerepelt URL-ben, érdemes újat létrehozni.
Az alábbi Gemini-útvonalakon: /v1beta/… a Google-kompatibilitás érdekében elfogadott a ?key= — a legalacsonyabb prioritással, a fejlécek után. ?api_key= itt is 400-as hibával kerül elutasításra. A megbízhatóbb megoldás továbbra is a kulcs átadása ezzel a fejléccel: x-goog-api-key.
Környezeti változók
Kényelmes egyetlen változót létrehozni, és azt használni a különböző programok beállításaiban:
# ~/.zshrc vagy ~/.bashrc
export AILOOT_API_KEY="sk-..."
# a szabványos neveket olvasó programokhoz
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-..."
# a szabványos neveket olvasó programokhoz
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-..."
# indítsa újra a terminált, hogy a változók elérhetővé váljanakA kulcs ellenőrzése
A kulcs ellenőrzésének legolcsóbb módja a modelllista lekérése: ez ingyenes.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"