Näin liität OpenAI API:n sovellukseesi
Kun liität OpenAI API:n, luo API-avain OpenAI-projektissa, tallenna se palvelinpuolen salaisuutena nimellä OPENAI_API_KEY ja kutsu rajapintaa omalta palvelimeltasi OpenAI:n virallisella SDK:lla, älä koskaan selainkoodista. Syyskuusta 2026 alkaen OpenAI:n pikaohje esittelee Responses API:n uusien projektien lähtökohtana. Aseta kulukatto ennen julkaisua, rajoita vastausten pituutta, rajoita kuinka usein jokainen käyttäjä voi kutsua ominaisuutta ja käsittele nopeusrajavirheet uudelleenyrityksillä.
Tämä opas kattaa asetukset, pyyntövirran, kehotteet tekoälyrakentajalle ja virheet, jotka vuotavat avaimia tai polttavat rahaa. OpenAI:n tiedot perustuvat sen viralliseen dokumentaatioon syyskuulta 2026. Yleiset käsitteet (tokenit, konteksti-ikkunat, hinnoittelu) kannattaa lukea ensin sivulta näin käytät LLM-rajapintoja.
Mitä sillä voi rakentaa
- Chat-avustaja sovelluksen sisällä (näin rakennat tekoälychatbot-sovelluksen)
- Painikkeet "Tiivistä tämä", "Muotoile tämä uudelleen" tai "Luonnostele vastaus"
- Jäsennellyn tiedon poimiminen vapaasta tekstistä: sähköpostin muuttaminen tilaukseksi, tukipyyntöjen luokittelu
- Haku ja kysymyksiin vastaaminen omasta sisällöstäsi
- Kuva-, puhe- ja muut mediaominaisuudet, riippuen saatavilla olevista malleista
Lisää ideoita on sivulla näin lisäät tekoälyominaisuuksia sovellukseesi.
OpenAI-tilin määrittäminen
- Luo tili ja projekti OpenAI-alustalla. OpenAI:n tuotantoa koskevat parhaat käytännöt suosittelevat erillisiä projekteja testaukseen ja tuotantoon, jotta kummallakin on omat avaimet ja rajat.
- Luo projektin API-avain. OpenAI suosittelee asettamaan avaimelle vanhenemispäivän ja vaihtamaan avaimet säännöllisesti.
- Aseta kulutushälytykset ja ehdoton kulukatto rajojen sivulla. OpenAI:n oppaan mukaan hälytykset ilmoittavat, kun käyttö ylittää summan, ja ehdoton raja pakottaa kuukausikaton.
- Lisää laskutustiedot. OpenAI:n nopeusrajadokumentaatio kuvaa käyttötasot: rajasi nousevat automaattisesti, kun käytät enemmän ajan myötä.
Pyyntövirta
Selain -> palvelinreittisi -> OpenAI API
<- (suoratoistettu) vastaus <-
- Käyttäjä klikkaa painiketta tai lähettää viestin.
- Selain kutsuu sinun reittiäsi, esimerkiksi
POST /api/summarise. - Palvelimesi tarkistaa, että käyttäjä on kirjautunut ja saa käyttää ominaisuutta.
- Palvelin rakentaa pyynnön: ohjeet, käyttäjän syötteen ja tehtävän tarvitsemat tiedot tietokannastasi.
- Se kutsuu OpenAI:ta ympäristömuuttujan avaimella. OpenAI:n SDK:t lukevat
OPENAI_API_KEY-muuttujan automaattisesti. - Se suoratoistaa tai palauttaa vastauksen ja kirjaa tokenien käytön.
OpenAI:n virallinen SDK-paketti on nimeltään openai sekä JavaScriptille/TypeScriptille (npm) että Pythonille (pip).
Mallin valinta
OpenAI tarjoaa useita malleja eri hinnoilla ja nopeuksilla, ja valikoima vaihtuu usein. Aloita pienemmällä ja halvemmalla mallilla, mittaa laatu oikeilla esimerkeillä ja siirry suurempaan vain tarvittaessa. Pidä mallin nimi asetusarvona tai salaisuutena, jotta voit vaihtaa sen kirjoittamatta koodia uudelleen. Tarkista ajantasaiset hinnat OpenAI:n hinnoittelusivulta.
Vaihtoehdot ja kompromissit
| Päätös | Yksinkertainen valinta | Milloin mennä pidemmälle |
|---|---|---|
| Suoratoisto | Palauta koko vastaus kerralla | Suoratoista chatissa ja pitkissä vastauksissa; käyttäjät näkevät tekstin heti |
| Keskustelumuisti | Lähetä viimeisimmät viestit joka kerta | Tiivistä vanhemmat viestit, kun keskustelut pitenevät |
| Tulosteen muoto | Pelkkä teksti | Pyydä jäsennelty JSON, kun koodisi tarvitsee lukea kenttiä |
| Oma data | Sisällytä asiaankuuluva tietue pyyntöön | Lisää haku omaan sisältöösi, kun sitä on liikaa (katso mikä RAG on) |
| Massatyö, ei kiireellinen | Käy kohteet läpi silmukassa | Käytä OpenAI:n eräajovaihtoehtoa halvemman hinnan takia, kun tulokset voivat odottaa |
Kehotteet tekoälyrakentajalle
Ensimmäinen ominaisuus:
Lisää painike "Tiivistä" tikettisivulle. Se kutsuu palvelinreittiä POST /api/summarise, joka tarkistaa, että käyttäjä on kirjautunut, lataa tiketin ja kutsuu OpenAI Responses API:a virallisella openai-SDK:lla ja salaisuudella OPENAI_API_KEY. Lue mallin nimi salaisuudesta OPENAI_MODEL. Ohjeet: "Tiivistä 3 luetelmakohdassa ja ehdota sitten lyhyt vastaus. Älä keksi tilausnumeroita." Rajoita tulosteen pituus, suoratoista vastaus sivulle äläkä koskaan lähetä avainta selaimelle.
Suojaukset:
Rajoita jokainen käyttäjä 30 tekoälypyyntöön tunnissa, tallennettuna tietokantaan. Kirjaa syöte- ja tulostokenit jokaisesta pyynnöstä käyttäjän ID:n ja ominaisuuden nimen kanssa. Jos OpenAI palauttaa 429, kunnioita Retry-After-otsikkoa, yritä uudelleen eksponentiaalisella viiveellä ja satunnaisuudella enintään kolme kertaa. Sen jälkeen näytä "Tekoäly on varattu, yritä minuutin kuluttua uudelleen." Näytä ystävällinen virheilmoitus kaikista muista virheistä ja pidä muu sivu toimivana.
Virheiden ja rajojen käsittely
OpenAI mittaa nopeusrajoja useilla tavoilla, kuten pyyntöinä minuutissa ja tokeneina minuutissa, ja osut siihen, joka loppuu ensin. Kun ylität rajan, API palauttaa 429-virheen ja Retry-After-otsikon. OpenAI:n dokumentaation mukaan tätä arvoa pitää käsitellä vähimmäisaikana, ja siihen kannattaa lisätä pieni satunnainen viive, jottei kaikki asiakkaat yritä uudelleen samaan aikaan.
Varaudu myös seuraaviin:
- Aikakatkaisut pitkissä generoinneissa. Suoratoisto auttaa, samoin järkevä tulosteen raja.
- Palveluntarjoajan katkokset. Tekoälyominaisuuden pitää epäonnistua hallitusti rikkomatta sivua.
- Huono tuloste. Validoi jäsennelty tuloste ennen tallentamista, äläkä anna mallin tulosteen käynnistää arkaluonteisia toimia ilman tarkistusta koodissasi.
Yleisiä virheitä
- Avain frontendissä tai repositoriossa. Selainkoodi on julkista, ja vuotanut avain voidaan väärinkäyttää minuuteissa. Katso näin pidät API-avaimet turvassa.
- Ei kulukattoa. Silmukka tai väärinkäyttäjä voi kasvattaa suuren laskun nopeasti.
- Ei käyttäjäkohtaisia rajoja. Palveluntarjoajan raja suojaa lompakkoasi, ei muita käyttäjiäsi.
- Turvallisuuden luottaminen kehotteeseen. Käyttäjät voivat kirjoittaa "unohda aiemmat ohjeet". Oikeudet kuuluvat palvelinkoodiin.
- Liian paljon lähettäminen. Koko asiakirjat ja pitkät historiat kertovat kustannuksia. Lähetä vain se, mitä tehtävä tarvitsee.
- Mallin nimen kovakoodaaminen. Malleja päivitetään ja poistetaan; tee siitä asetus.
- Henkilötietojen lähettäminen ajattelematta. Lue OpenAI:n datan käyttöehdot ja lähetä vain ominaisuuden tarvitsema tieto.
Tarkistuslista
- Erilliset OpenAI-projektit (tai avaimet) testaukseen ja tuotantoon
- Avain tallennettu palvelinpuolen salaisuutena, ei koskaan selainkoodiin tai repositorioon
- Kulutushälytykset ja ehdoton kulukatto asetettu
- Kaikki kutsut kulkevat palvelimesi kautta ja tarkistavat käyttäjän oikeudet
- Tulosteen pituus rajattu; mallin nimi säädettävissä
- Käyttäjäkohtainen nopeusraja sovelluksessasi
- 429-virheet käsitelty Retry-After-otsikolla, viiveellä ja satunnaisuudella
- Ystävällinen virhetila; sivu toimii ilman tekoälyä
- Tokenien käyttö kirjattu ominaisuuskohtaisesti
- Testattu pitkillä, tyhjillä ja vihamielisillä syötteillä
OpenAI API:n käyttö Mythexissä
Tekoälyominaisuudet Mythexillä rakentamissasi sovelluksissa käyttävät omaa OpenAI-avaintasi, ja ne laskutetaan OpenAI-tililtäsi eivätkä Mythexin rakennusluotoilta. Lisää OPENAI_API_KEY projektin salaisuudeksi kohdassa /secrets, projektin asetuksissa tai salaisuuskortissa, jonka agentti näyttää, kun se tarvitsee avaimen. Kuvaile sitten ominaisuus yllä olevien kaltaisella kehotteella. Kun muutat salaisuuksia julkaistussa sovelluksessa, julkaise se uudelleen, jotta se ottaa ne käyttöön. Dokumentaation ohje Lisää tekoälyominaisuudet omilla API-avaimillasi sisältää aloituskehotteen, ja Salaisuudet chatissa selittää salaisuuskortin. Vertailetko palveluntarjoajia? Katso näin liität Claude API:n.
Kysymykset
Mitä OpenAI API:a kannattaa käyttää uudessa sovelluksessa?
OpenAI:n pikaohjeen mukaan syyskuusta 2026 alkaen uusien projektien lähtökohta on Responses API. Sen esimerkit käyttävät virallisissa SDK:issa kutsua client.responses.create(). Tarkista OpenAI:n dokumentaatiosta ajantasainen suositus ennen aloittamista.
Voinko kutsua OpenAI API:a selaimesta?
Et salaisella avaimellasi. Kuka tahansa voi lukea selaimen koodia ja käyttää avainta laskusi kasvattamiseen. Selaimen pitää kutsua omaa palvelinreittiäsi, ja palvelimesi kutsuu OpenAI:ta avaimella, joka on tallennettu ympäristömuuttujaksi.
Miten estän OpenAI API:n kustannusten kasvamisen liian suuriksi?
OpenAI:n tuotantoa koskevan oppaan mukaan kannattaa asettaa kulutushälytykset ja kuukausittainen ehdoton kulukatto rajojen sivulle. Sovelluksessasi rajoita vastausten pituutta, rajaa pyyntöjä käyttäjää kohden ja kirjaa tokenien käyttö, jotta näet, mitkä ominaisuudet maksavat eniten.
Mitä 429-virhe OpenAI:lta tarkoittaa?
Se tarkoittaa, että olet ylittänyt nopeusrajan. OpenAI:n nopeusrajadokumentaation mukaan vastauksessa on Retry-After-otsikko. Odota vähintään sen verran, lisää pieni satunnainen viive ja yritä uudelleen eksponentiaalisella viiveellä.