Avaimet ja API-osoite
MarkdownMistä saat avaimen, mikä osoite annetaan eri SDK:ille ja miten avain lähetetään.
Koko opas
API-avain
Avain luodaan hallintapaneelissa osoitteessa ailoot.ai kun olet rekisteröitynyt. Se näyttää tältä: sk-…. Voit luoda useita avaimia: erikseen työkoneelle, palvelimelle ja jokaiselle sovellukselle — näin yhden avaimen voi mitätöidä muita muuttamatta.
Avaimelle voi asettaa kokonaiskulutusrajan, voimassaoloajan, sallittujen ja estettyjen IP-osoitteiden luettelot sekä kulutusrajat jaksoille 5 tuntia, 1 päivä ja 7 päivää. Jos rajoitus täyttyy, saat ymmärrettävän virheen: api_key_quota_exhausted (kokonaisraja käytetty), usage_limit_reached (avaimen kulutusjakso käytetty — odota jakson uusiutumista tai nosta rajaa), api_key_expired tai permission_denied (esimerkiksi pyyntö muusta kuin sallitusta IP:stä).
API-osoite
Pääsääntö: OpenAI-yhteensopiville asiakkaille osoite sisältää /v1, Anthropicille ja Geminille ei sitä.
| Asiakas | Perusosoite | Mihin pyyntö lähetetään |
|---|---|---|
| OpenAI SDK ja yhteensopivat asiakkaat | 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 |
| Asiakas pyytää koko osoitteen | https://api.ailoot.ai/v1/chat/completions | kuten ilmoitettu |
Avaimen lähettäminen
Ailoot hyväksyy avaimen missä tahansa kolmesta otsakkeesta — SDK:si lähettämä otsake käy:
| Otsake | Kuka lähettää näin |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, useimmat asiakkaat |
x-api-key: sk-… | Anthropic SDK, Claude Code muuttujalla ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Poluissa /v1/… osoitteessa olevaa avainta (?key= tai ?api_key=) ei hyväksytä: pyyntö saa 400-virheen koodilla invalid_request ja viestillä, että avain lähetettiin osoitteessa. Näin avain ei päädy lokeihin tai selainhistoriaan. Jos avain on jo ollut osoitteessa, kannattaa luoda uusi.
Gemini-poluissa /v1beta/… Google-yhteensopivuuden vuoksi hyväksytään ?key= — alimmalla prioriteetilla, otsakkeiden jälkeen. ?api_key= hylätään sielläkin koodilla 400. Avaimen lähettäminen otsakkeessa on silti turvallisempaa: x-goog-api-key.
Ympäristömuuttujat
On kätevää luoda yksi muuttuja ja käyttää sitä eri ohjelmien asetuksissa:
# ~/.zshrc tai ~/.bashrc
export AILOOT_API_KEY="sk-..."
# ohjelmille, jotka lukevat vakiomuuttujanimet
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-..."
# ohjelmille, jotka lukevat vakiomuuttujanimet
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-..."
# käynnistä terminaali uudelleen, jotta muuttujat tulevat käyttöönAvaimen tarkistus
Edullisin tapa tarkistaa avain on pyytää malliluettelo: se on maksutonta.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"