Source: https://ailoot.ai/docs/fi/keys/
Canonical: https://ailoot.ai/docs/fi/keys/
Language: fi

[Aloitus](https://ailoot.ai/docs/fi/) 

# Avaimet ja API-osoite

[Markdown](https://ailoot.ai/docs/fi/keys/index.md)

Mistä saat avaimen, mikä osoite annetaan eri SDK:ille ja miten avain lähetetään.

## [](https://ailoot.ai/docs/fi/keys/#key)API-avain

Avain luodaan hallintapaneelissa osoitteessa [ailoot.ai](https://ailoot.ai) kun olet [rekisteröitynyt](https://ailoot.ai/register). 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ä).

Älä julkaise avainta koodissa, lähdekoodivarastoissa tai kuvakaappauksissa. Säilytä sitä ympäristömuuttujassa tai salaisuuksien hallintatyökalussa. Jos avain on vuotanut, poista se hallintapaneelissa ja luo uusi.

## [](https://ailoot.ai/docs/fi/keys/#base-url)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 |

Saitko 404-virheen heti asetusten jälkeen? Ongelma on lähes aina osoitteessa: ylimääräinen tai puuttuva `/v1`, kaksinkertainen kauttaviiva tai `/chat/completions` kohdassa, jossa asiakas lisää sen itse.

## [](https://ailoot.ai/docs/fi/keys/#auth)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`.

## [](https://ailoot.ai/docs/fi/keys/#env)Ympäristömuuttujat

On kätevää luoda yksi muuttuja ja käyttää sitä eri ohjelmien asetuksissa:

```bash
# ~/.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"
```

```powershell
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öön
```

## [](https://ailoot.ai/docs/fi/keys/#check)Avaimen tarkistus

Edullisin tapa tarkistaa avain on pyytää malliluettelo: se on maksutonta.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.