Skip to content

Johdanto OpenRouteriin

Mikä OpenRouter on?

OpenRouter on palvelu, joka tarjoaa yhden API-rajapinnan useiden eri tekoälymallien käyttämiseen.

Sen sijaan, että jokaiselle mallipalvelulle tarvitsisi rakentaa erillinen integraatio, OpenRouter toimii välikerroksena:

OMA SOVELLUS / AGENTTI / TYÖKALU
              │
              │ API
              ▼
         OPENROUTER
              │
       ┌──────┼──────────────┐
       ▼      ▼              ▼
     Malli A  Malli B       Malli C

Tämä mahdollistaa saman API-yhteyden käyttämisen useiden eri mallien kanssa. Mallia voidaan vaihtaa yleensä muuttamalla vain mallin tunnistetta.

API-avain, mallin tunniste ja provider

OpenRouterissa on tärkeää ymmärtää kolme eri käsitettä:

API-avain

Salainen tunniste, jolla OpenRouter tunnistaa pyynnön lähettäjän. Avain näyttää suunnilleen tältä:

sk-or-v1-xxxxxxxxxxxxxxxx

Mallin tunniste

Määrittää, mitä tekoälymallia käytetään. Esimerkiksi:

 model: "poolside/laguna-s-2.1:free"

Provider

Mallia suorittava palveluntarjoaja. OpenRouter voi välittää saman mallin useiden eri providerien kautta.

Tärkeä ero

API-avain ja mallin tunniste eivät ole sama asia. API-avaimella tunnistaudutaan OpenRouteriin, ja mallin tunniste määrittää, mitä mallia käytetään.

Claude Code ja OpenRouter

Claude Code voidaan yhdistää OpenRouteriin Anthropic API -yhteensopivuuden kautta. Tyypillinen ympäristöasetusten kokonaisuus on:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-xxxxxxxx",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "poolside/laguna-s-2.1:free"
  }
}

Huomio

Claude Code on suunniteltu ensisijaisesti Anthropic-malleille. Muiden palveluntarjoajien mallien yhteensopivuus voi vaihdella — katso LLM-mallin valinta Claude Codessa tarkempaa ohjetta varten.

Onko OpenRouter ilmainen?

OpenRouterissa on sekä ilmaisia että maksullisia malleja.

Ilmaismallit tunnistaa mallin nimen lopussa olevasta :free-päätteestä

poolside/laguna-s-2.1:free

Mistä ilmaismallit löytyvät?

Ilmaismalleja voi etsiä Models‑välilehdeltä käyttämällä hakutekijää: :free OpenRouter – Models

Ilmaismallien käyttöä rajoitetaan kuitenkin pyyntömäärillä:

Tilanne Ilmaiset mallikutsut / vrk Kutsut / min
Tili ilman ostettuja krediittejä 50 20
Tilille lisätty vähintään $10 krediittiä 1 000 20

Maksullisissa malleissa käyttö veloitetaan mallin ja palveluntarjoajan hinnaston perusteella.

Tärkeä periaate

Ilmainen malli ($0 / token) ei tarkoita rajatonta käyttöä — ilmaismallien pyyntömäärää rajoitetaan erikseen.

OpenRouterin automaattinen reititys

OpenRouterissa on myös automaattinen mallireititys:

openrouter/auto

Tässä tilassa OpenRouter valitsee mallin tehtävätyypin, käyttödatan ja kustannustason perusteella. Jos tavoitteena on käyttää aina tiettyä mallia, on parempi määrittää se suoraan.

OpenRouter Default Model – Ilmaismallin asettaminen oletukseksi

OpenRouterin työtilassa (Workspace) on asetus nimeltä Default Model, joka määrittää:

  • mitä mallia sovellukset käyttävät oletuksena
  • mitä mallia käytetään fallback‑mallina, jos pyydetty malli ei ole saatavilla

Voit avata työtilan malliasetukset täältä:

OpenRouter – Workspace Default Routing

Miksi ilmaismalli kannattaa asettaa oletusmalliksi?

Jos käytät OpenRouteria sovelluksissa, agenteissa tai CLI‑työkaluissa, on järkevää asettaa ilmaismalli oletukseksi, jotta:

  • kutsut eivät kuluta krediittejä vahingossa
  • fallback‑malli ei vaihdu maksulliseen malliin
  • agentit ja skriptit pysyvät kustannusturvallisina
  • malli on aina saatavilla ilman rajoituksia maksullisten mallien suhteen

Seuraavaksi