Source: https://ailoot.ai/docs/fi/ Canonical: https://ailoot.ai/docs/fi/ Language: fi [Aloitus](https://ailoot.ai/docs/fi/) # Pika-aloitus — API-avain ja ensimmäinen ohjelmointipyyntö [Markdown](https://ailoot.ai/docs/fi/index.md) Ensimmäinen mallivastaus Ailootin kautta parissa minuutissa: avain, osoite ja yksi pyyntö. Ailoot on yhteinen API eri yritysten tekoälymalleille: OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside ja TypeSafe. Yksi avain, yksi saldo dollareina. Luettelossa on 1256 mallikorttia ja 2692 dokumentoitua menetelmää. Vaihtoehtoiset kutsutunnisteet tai aliakset näkyvät valitun menetelmän kohdalla, jos niitä on saatavilla. Ailoot käyttää kolmea API-muotoa: OpenAI, Anthropic ja Gemini. Siksi valmiit SDK:t ja lähes kaikki sovellukset, joissa voi antaa oman API-osoitteen, sopivat: Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n ja kymmenet muut. | Tapa | Milloin sopii | | --- | --- | | [HTTP-pyyntö](https://ailoot.ai/docs/fi/connect/curl/) | Mikä tahansa kieli, ei riippuvuuksia, nopea avaimen tarkistus | | [OpenAI SDK](https://ailoot.ai/docs/fi/connect/openai-sdk/) | Python ja Node.js; kaikki luettelon mallit OpenAI-muodossa | | [Anthropic SDK](https://ailoot.ai/docs/fi/connect/anthropic-sdk/) | Claude ja muut mallit Messages-muodossa | | [Valmiit sovellukset](https://ailoot.ai/integrations/fi/) | 85 agenttia, editoria ja chatia: 77 valmiilla asetuksilla, 8 tarkistettavana | Tarvitsetko tietyn ohjelman? Avaa [integraatioluettelo](https://ailoot.ai/integrations/fi/): kullekin näytetään, mihin osoite ja avain lisätään, sekä valmis kopioitava konfiguraatio. ## Luo API-avain sovelluksellesi [](https://ailoot.ai/docs/fi/#key)Hanki avain 1. **Rekisteröidy** Luo tili osoitteessa [ailoot.ai/register](https://ailoot.ai/register). Kirjaudu sen jälkeen osoitteessa [ailoot.ai/login](https://ailoot.ai/login). 2. **Lataa saldoa** Avaa hallintapaneelin ”Hinnoittelu”-osio: kertalataus alkaen $18 tai tilaus saldobonuksella. Lisätietoja: [saldon lataus](https://ailoot.ai/docs/fi/billing/topup/) ja [tilaukset](https://ailoot.ai/docs/fi/billing/subscriptions/). 3. **Luo API-avain** Avaa hallintapaneelin avainosio ja luo uusi avain. Avain alkaa merkkijonolla `sk-`. Voit kopioida sen hallintapaneelin avainosiosta; säilytä sitä kuin salasanaa. Tallenna avain ympäristömuuttujaan ```bash export AILOOT_API_KEY="sk-..." # tarkistus: vastauksena pitää palautua malliluettelo curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300 ``` ## [](https://ailoot.ai/docs/fi/#first-request)Lähetä ensimmäinen pyyntö API-osoite on `https://api.ailoot.ai`. OpenAI-muotoisille SDK:ille perusosoite on `https://api.ailoot.ai/v1`, Anthropicille ja Geminille — `https://api.ailoot.ai` ilman päätettä: nämä SDK:t lisäävät polun itse. ```bash curl https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [ {"role": "user", "content": "Selitä kahdella lauseella, mitä API tarkoittaa."} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "Selitä kahdella lauseella, mitä API tarkoittaa."}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "Selitä kahdella lauseella, mitä API tarkoittaa." }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # ilman /v1-osaa: SDK lisää itse /v1/messages-osan api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Selitä kahdella lauseella, mitä API tarkoittaa."}], ) print(msg.content[0].text) ``` Vastaus saapuu tutussa muodossa. Lohko `usage` kertoo, paljonko tokeneita kului kysymykseen ja vastaukseen: veloitus lasketaan niiden perusteella. 200 OK ```json { "id": "chatcmpl-8f2c…", "object": "chat.completion", "created": 1790812800, "model": "claude-sonnet-5-5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "API on sopimus siitä, miten yksi ohjelma pyytää toista tekemään jotakin…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 21, "completion_tokens": 48, "total_tokens": 69 } } ``` ## [](https://ailoot.ai/docs/fi/#streaming)Suoratoistovastaus Asetuksella `"stream": true` vastaus saapuu Server-Sent Events -muodossa kuten alkuperäisissä APIeissa, joten SDK:t ja asiakkaat tulkitsevat sen ilman muutoksia. OpenAI SDK:ssa on kätevää pyytää lopullinen `usage` viimeisessä tapahtumassa. Ailoot palauttaa maksullisen tekstivastauksen hinnan laskemisen jälkeen. Siksi asetuksella `stream: true` muoto pysyy virtamuotoisena (SSE), mutta teksti saapuu yhtenä lohkona mallin valmistuttua, ei sana kerrallaan. Jos vastauksen valmistuminen kestää yli noin 15 sekuntia, Chat Completions-, Responses- ja Messages-virroissa saapuvat ensin palvelurivit `: ping` (noin 10 sekunnin välein), sitten rivi `: ailoot-charged-usd …` veloitussummalla ja itse tiedot. SDK:t ohittavat tällaiset rivit. ```python stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "Kirjoita haiku sateesta"}], stream=True, stream_options={"include_usage": True}, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ```js const stream = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "Kirjoita haiku sateesta" }], stream: true, stream_options: { include_usage: true }, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "Kirjoita haiku sateesta"}]}' ``` ## [](https://ailoot.ai/docs/fi/#models)Valitse malli Kenttä `model` — tarkka tunniste [malliluettelosta](https://ailoot.ai/models/fi/) tai vastauksesta `GET /v1/models`. Monilla malleilla on lyhyet aliakset, esimerkiksi `claude-sonnet-latest` tai `qwen`. Luettelosta näet, mihin malliin alias nyt viittaa; käytä tarkkaa ID:tä toistettaviin tuloksiin. | Tehtävä | Mistä aloittaa | | --- | --- | | Koodi ja agentit | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` | | Nopeasti ja edullisesti | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` | | Pitkä konteksti, enintään 1M tokenia | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` | | Kuvat | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` | Kaikki mallit eivät ole saatavilla kaikissa muodoissa. Esimerkiksi Gemini-mallit toimivat Anthropic Messages -muodossa ja omassa Gemini-muodossaan, mutta OpenAI Chatin kautta vain `gemini-3.6-flash`. Mallin käytettävissä olevat muodot näkyvät [luettelossa](https://ailoot.ai/models/fi/). ## [](https://ailoot.ai/docs/fi/#next)Mitä seuraavaksi [**Näin se toimii** Pyynnön kulku, varaus ja veloitus, virheet](https://ailoot.ai/docs/fi/how-it-works/) [**Yhteensopivuus** Tuetut muodot ja asiakkaat](https://ailoot.ai/docs/fi/compatibility/) [**Integraatiot** 77 sovellusta valmiilla asetuksilla](https://ailoot.ai/integrations/fi/) [**Virheet ja rajoitukset** Vastauskoodit ja toimenpiteet](https://ailoot.ai/docs/fi/errors/) Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai) ## API-avain ja ensimmäinen ohjelmointipyyntö ### Mistä luon Ailoot API-avaimen? Avaa hallintapaneelin avainosio ja luo uusi avain. Avain alkaa merkkijonolla sk-. Voit kopioida sen hallintapaneelin avainosiosta; säilytä sitä kuin salasanaa. Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Kysymykset Miten lähetän ensimmäisen API-pyyntöni? Luo Ailoot API-avain. Aseta OpenAI SDK:n osoitteeksi https://api.ailoot.ai/v1 tai Anthropic ja Gemini SDK:n osoitteeksi https://api.ailoot.ai. GET /v1/models on maksuton ja luettelee avaimesi käytettävissä olevat mallit; käytä sen jälkeen valitun mallin ja API-menetelmän esimerkkiä. Mitä API-avainta minun tulee käyttää? Käytä tililtäsi saatavaa Ailoot API-avainta valitun asiakasohjelmamuodon todennuskentässä. Lähetä GET /v1/models samalla avaimella, niin voit tarkistaa maksutta, mihin malleihin sillä on pääsy; toisen palvelun avain ei anna pääsyä Ailoot-palveluun. Mitä tarkistan, jos ensimmäinen pyyntö epäonnistuu? Vertaa API-osoitetta, Ailoot API-avainta, mallin tarkkaa ID:tä ja API-menetelmää mallikorttiin ja pyyntöesimerkkiin. Lue palautettu virheilmoitus; jos tarvitset apua, lähetä virheilmoitus ja pyynnön ID osoitteeseen support@ailoot.ai ilman API-avaintasi. Mitä tilaus antaa? Alennuksen tokenien ostamiseen säännöllistä käyttöä varten. Valitse paketti pyyntömääräsi mukaan; tilauksen ehdot ja hinta näkyvät tilatessa. Miten käytän kampanjakoodin jopa 50% alennuksen? Syötä kampanjakoodi tokeniostossa. Lopullinen summa lasketaan kampanjaehtojen mukaan; alennuksen määrä näkyy ennen maksua. ## 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.