# GenderAPI.io hinnat API-paketit ja krediitit

> Aloita maksuttomalla tilillä, valitse kuukausikrediitit säännölliseen käyttöön tai osta krediittipaketti kertamaksulla. V2-pyynnöt maksavat 1 tai 2 krediittiä tekoälyasetusten mukaan.

Canonical HTML: https://www.genderapi.io/fi/price

Last reviewed: 2026-09-30

## Maksuton tili ja IP-kokeilu

Rekisteröity maksuton tili käyttää API-avainta ja saa 200 krediittiä päivässä. Se riittää enintään 200 vakiopyyntöön, jotka maksavat 1 krediitin; jotkin tekoälytilat maksavat 2 krediittiä kohdetta kohden.

V2:n IP-kokeilu antaa ilman rekisteröitymistä 10 krediittiä julkista IP-osoitetta kohden 24 tunnin välein. Sitä käytetään, kun API-avain puuttuu, sen muoto on virheellinen tai sitä ei tunnisteta. Kaikki saman julkisen IP-osoitteen käyttäjät jakavat tämän saldon, ja myös V1:n kokeilukäyttö vähennetään siitä. Tunnistetut avaimet, jotka on poistettu käytöstä, jotka ovat vanhentuneet tai joita on rajoitettu, eivät siirry IP-kokeiluun.

## Krediittipaketit

Hinnat ovat peräisin samasta luettelosta kuin HTML-hintasivu. Tarkista ajantasaiset ehdot ja kokonaissumma hintasivulta ennen ostoa.

| Paketti | Krediitit | Kuukausittain (EUR) | Kertamaksu (EUR) |
| --- | --- | --- | --- |
| Tester | 5 000 | 6.69 | 8.39 |
| Mini | 25 000 | 15 | 19 |
| Start-Up | 50 000 | 25 | 30 |
| Basic | 100 000 | 40 | 50 |
| Basic+ | 200 000 | 50 | 60 |
| Pro | 500 000 | 75 | 90 |
| Advanced | 1 000 000 | 90 | 110 |
| Premium | 2 000 000 | 130 | 160 |
| Elite | 5 000 000 | 200 | 250 |
| Enterprise | 10 000 000 | 300 | 370 |
| Ultra | 20 000 000 | 450 | 560 |
| Ultimate | 50 000 000 | 900 | 1100 |

## Krediittien käyttö V2:ssa

Krediitit vastaavat tehtyä työtä, eivät HTTP-pyyntöjen määrää. Alla olevat hinnat koskevat V2-pyyntöjä, joissa käsitellään nimiä, sähköpostiosoitteita ja käyttäjänimiä. V1 ja V2 käyttävät nykyistä API-avaintasi ja samaa tilin saldoa.

Onnistuneesti käsitelty tulos ilman ennustetta (gender: null) veloitetaan valitun tilan hinnalla. Ennen veloitusta havaitut syötteen validointivirheet eivät kuluta krediittejä; epäonnistuneita ennusteita ei veloiteta, kun krediittien palautus on vahvistettu. Jos veloituksen lopputulosta ei ole vahvistettu, tarkista billing_status.

Eräpyyntö veloitetaan jokaisesta onnistuneesti käsitellystä kohteesta, ei kerran HTTP-pyyntöä kohden. Eräpyynnön kohteet käyttävät oletuksena vain tietoaineistoa; määritä tarvittaessa fallback, always tai forceToGenderize yksittäisille kohteille. Eräpyyntö, jossa on 50 onnistuneesti käsiteltyä 1 krediitin vakiokohdetta, maksaa 50 krediittiä. API-avaimella eräpyynnössä voi olla enintään 50 kohdetta, IP-kokeilussa enintään 10.

Yksittäisen pyynnön tai eräpyynnön aloittamiseen riittää vähintään 1 krediitin jäljellä oleva saldo. Koko hinta veloitetaan kuitenkin, joten saldo voi painua negatiiviseksi: 2 krediitin pyyntö, joka aloitetaan 1 krediitin saldolla, jättää saldoksi -1. Kun saldo on 0 tai pienempi, uusia maksullisia toimintoja ei voi tehdä.

Jokainen toistettu pyyntö on erillinen toiminto, ja se veloitetaan tavalliseen tapaan. Älä toista automaattisesti pyyntöjä, joiden tulos tai veloitus on epäselvä.

| Toiminto | Krediittiä kohdetta kohden | Kuvaus |
| --- | --- | --- |
| Vain tietoaineisto | 1 | Asetuksella ai_mode: off käytetään vain tietoaineistoa ilman tekoälykutsua. |
| Vakiopyyntö, tekoäly varalla | 1 | Asetuksella ai_mode: fallback haetaan ensin tietoaineistosta; tekoälyä käytetään vain, jos sukupuolta ei voida määrittää. Hinta on yhteensä 1 krediitti, vaikka tekoälyä käytettäisiin. Tämä on yksittäisten pyyntöjen oletustila. |
| Pyyntö suoraan tekoälylle | 2 | Asetuksella ai_mode: always tietoaineisto ohitetaan ja pyyntö lähetetään suoraan tekoälylle. |
| Lempinimianalyysi: tulos tietoaineistosta | 1 | Asetuksella forceToGenderize: true haetaan ensin tietoaineistosta. Tietoaineistosta määritetty sukupuoli maksaa 1 krediitin. |
| Lempinimianalyysi: tulos tekoälyltä | 2 | Jos tietoaineisto ei asetuksella forceToGenderize: true pysty määrittämään sukupuolta, tekoäly tulkitsee nimen, sähköpostiosoitteen tai käyttäjänimen myös ilman oikeaa etunimeä. Hinta on yhteensä 2 krediittiä. |
| Puhelinnumeron tarkistus | 1 | Suoritettu numeron tarkistus maksaa 1 krediitin, vaikka tulos olisi valid: false. |
| Saldon tarkistus | 0 | GET /api/v2/usage ei kuluta krediittejä, mutta se lasketaan mukaan pyyntörajoihin. |

## Pyyntörajat

V2:ssa on kaikissa paketeissa rajoituksia pyyntöjen määrälle ja samanaikaisille pyynnöille. Saldo ja pyyntörajat ovat toisistaan riippumattomia: käsittele HTTP 429 ja odota Retry-After-otsakkeessa ilmoitettu aika ennen seuraavan pyynnön lähettämistä. Ajantasaiset oletusarvot ja vastausotsakkeet kuvataan V2-dokumentaatiossa.

- [V2:n krediitti- ja käyttöopas](https://www.genderapi.io/fi/docs/v2/credits-and-usage)
- [V2:n virhe- ja uudelleenyritysopas](https://www.genderapi.io/fi/docs/v2/errors-and-retries)
- [V1-dokumentaatio](https://www.genderapi.io/fi/api-documentation/v1)

## Maksaako jokainen API-pyyntö aina tasan yhden krediitin?

Ei. Tavallinen V2-pyyntö maksaa 1 krediitin, myös silloin, kun tekoäly on varalla. ai_mode: always maksaa 2 krediittiä. forceToGenderize maksaa 1 krediitin, kun tulos saadaan tietoaineistosta, tai 2 krediittiä, kun tekoälyä käytetään. Eräpyyntö veloitetaan jokaisesta onnistuneesti käsitellystä kohteesta, ja myös onnistuneesti käsitelty tuntematon tulos veloitetaan.

## Mitä eroa on maksuttomalla tilillä ja IP-kokeilulla?

Rekisteröity tili käyttää API-avainta ja saa 200 maksutonta krediittiä päivässä. V2:n IP-kokeilu ei vaadi avainta ja antaa 10 krediittiä julkista IP-osoitetta kohden 24 tunnin välein; saman IP-osoitteen muut käyttäjät ja V1:n kokeilukäyttö jakavat nämä krediitit. Molemmissa tapauksissa pyyntöjen tavalliset hinnat ovat voimassa.

## Koskevatko pyyntörajat myös maksullisia paketteja?

Kyllä. V2:ssa on rajoituksia pyyntöjen määrälle ja samanaikaisille pyynnöille saldosta riippumatta. Suurempi krediittipaketti ei poista näitä rajoja. Käsittele HTTP 429, noudata Retry-After-otsaketta ja tarkista ajantasaiset rajat V2-dokumentaatiosta.