Hvernig þú tengir OpenAI API við appið þitt

Til að tengja OpenAI API skaltu búa til API-lykil í OpenAI-verkefni, geyma hann sem leyndarmál á netþjóni undir heitinu OPENAI_API_KEY og kalla á API-ið frá leið á þínum eigin netþjóni með opinbera SDK-inu frá OpenAI, aldrei úr kóða sem keyrir í vafranum. Frá september 2026 kynnir flýtileiðbeining OpenAI Responses API sem upphafspunkt fyrir ný verkefni. Settu eyðslumörk fyrir opnun, takmarkaðu lengd svara, takmarkaðu hversu oft hver notandi getur kallað á eiginleikann og meðhöndlaðu villur vegna hraðatakmarkana með endurtilraunum.

Þessi leiðbeining fjallar um uppsetningu, beiðnaflæðið, fyrirmæli fyrir AI-smiðinn og mistökin sem leka lyklum eða brenna peningum. Upplýsingar um OpenAI eru úr opinberu skjölunum frá september 2026. Fyrir almenn hugtök (tákn, samhengisglugga, verðlagningu) skaltu lesa hvernig þú notar LLM API fyrst.

Það sem þú getur smíðað með þessu

• Spjallaðstoðarmann inni í appinu þínu (hvernig þú smíðar AI-spjallmenni)
• Hnappa fyrir „Taka saman“, „Endurskrifa“ eða „Semja svar“
• Að draga strúktúraðar upplýsingar úr frjálsum texta: breyta tölvupósti í pöntun, merkja þjónustubeiðnir
• Leit og spurningasvörun yfir þitt eigið efni
• Myndgerð, tal og aðra miðlaeiginleika, eftir því hvaða líkön eru í boði

Fleiri hugmyndir eru í hvernig þú bætir AI-eiginleikum við appið þitt.

Uppsetning OpenAI-reikningsins

1. Búðu til reikning og verkefni á OpenAI-vettvangnum. Bestu starfshættir OpenAI fyrir framleiðslu mæla með aðskildum verkefnum fyrir prófun og framleiðslu, svo hvort um sig geti haft sína eigin lykla og mörk.
2. Búðu til verkefnalykil. OpenAI mælir með því að setja gildistíma og skipta um lykla reglulega.
3. Settu tilkynningar um eyðslu og hart eyðslumark á takmarkasíðunni. Leiðbeiningar OpenAI segja að tilkynningar láti þig vita þegar notkun fer yfir ákveðna upphæð, og hart mark framfylgi mánaðarlegu þaki.
4. Bættu við greiðslum. Skjöl OpenAI um hraðatakmarkanir lýsa notkunarþrepum: mörk þín hækka sjálfkrafa eftir því sem þú eyðir meira yfir tíma.

Beiðnaflæðið

Vafri  ->  þín netþjónsleið  ->  OpenAI API
       <-  (streymt) svar   <-

1. Notandinn smellir á hnapp eða sendir skilaboð.
2. Vafrinn kallar á þína leið, til dæmis POST /api/summarise.
3. Netþjónninn athugar að notandinn sé innskráður og megi nota eiginleikann.
4. Netþjónninn setur saman beiðnina: fyrirmæli, inntak notandans og gögn úr gagnagrunninum sem verkefnið þarf.
5. Hann kallar á OpenAI með lyklinum úr umhverfinu. SDK-in frá OpenAI lesa OPENAI_API_KEY sjálfkrafa.
6. Hann streymir eða skilar svarinu og skráir táknnotkun.

Opinberi SDK-pakki OpenAI heitir openai bæði fyrir JavaScript/TypeScript (npm) og Python (pip).

Að velja líkan

OpenAI býður upp á nokkur líkön á mismunandi verði og hraða, og úrvalið breytist oft. Byrjaðu með minna, ódýrara líkani, mældu gæðin á raunverulegum dæmum og farðu upp aðeins ef þú þarft. Geymdu heiti líkansins í stillingagildi eða leyndarmáli svo þú getir skipt um það án þess að endurskrifa kóðann. Skoðaðu verðlagnarsíðu OpenAI fyrir núverandi gjöld.

Valkostir og málamiðlanir

Fyrirmæli fyrir AI-smiðinn þinn

Fyrsti eiginleiki:

Bættu við hnappinum „Taka saman“ á síðu verkefnisins. Hann kallar á netþjónsleiðina POST /api/summarise sem athugar að notandinn sé innskráður, sækir verkefnið og kallar á OpenAI Responses API með opinbera openai SDK-inu og leyndarmálinu OPENAI_API_KEY. Lestu heiti líkansins úr leyndarmálinu OPENAI_MODEL. Fyrirmæli: „Taktu saman í 3 punktum og stingdu síðan upp á stuttu svari. Ekki búa til pöntunarnúmer.“ Takmarkaðu lengd úttaksins, streymdu svarinu á síðuna og láttu lykilinn aldrei ná vafranum.

Varnir:

Takmarkaðu hvern notanda við 30 AI-beiðnir á klukkustund, geymdar í gagnagrunninum. Skráðu inntaks- og úttakstákn fyrir hverja beiðni ásamt notandaauðkenni og heiti eiginleikans. Ef OpenAI skilar 429, virtu Retry-After hausinn og reyndu aftur með veldisvaxandi bið og slembitöf allt að 3 sinnum; eftir það sýndu „AI-ið er upptekið, reyndu aftur eftir mínútu.“ Sýndu vinalega villu við allar aðrar bilanir og láttu restina af síðunni virka áfram.

Meðhöndlun villna og marka

OpenAI mælir hraðatakmarkanir á nokkra vegu, þar á meðal beiðnir á mínútu og tákn á mínútu, og þú lendir á þeirri sem klárast fyrst. Þegar þú ferð yfir eitt þeirra skilar API-ið 429 með Retry-After haus. Skjöl OpenAI segja að taka eigi þessu gildi sem lágmarki og bæta við lítilli slembitöf svo viðskiptavinir reyni ekki allir aftur á sama tíma.

Gerðu einnig ráð fyrir:

• Tímamörkum á löngum kynslóðum. Streymi hjálpar, og það gerir líka skynsamlegt þak á úttakið.
• Bilunum hjá þjónustuaðila. AI-eiginleikinn ætti að bila mjúklega án þess að brjóta síðuna.
• Lélegu úttaki. Staðfestu strúktúrað úttak áður en þú vistar það, og láttu úttak líkansins ekki kveikja á viðkvæmum aðgerðum án athugunar í kóðanum þínum.

Algeng mistök

• Lykill í framenda eða í geymslunni. Kóði í vafra er opinber og lekinn lykill getur verið misnotaður innan nokkurra mínútna. Sjá hvernig þú heldur API-lyklum öruggum.
• Ekkert eyðslumark. Lykkja eða móðgandi notandi getur keyrt upp stóran reikning fljótt.
• Engin takmörk á hvern notanda. Takmörk þjónustuaðilans vernda veskið þitt, ekki hina notendurna þína.
• Að treysta fyrirmælunum fyrir öryggi. Notendur geta skrifað „hunsa fyrri fyrirmæli“. Heimildir eiga heima í netþjónskóðanum.
• Að senda meira en þarf. Heil skjöl og löng samtalsferli margfalda kostnaðinn. Sendu það sem verkefnið þarf.
• Harðkóðað heiti líkans. Líkön eru uppfærð og aflögð; gerðu það að stillingu.
• Að senda persónuupplýsingar án umhugsunar. Lestu gagnanotkunarskilmála OpenAI og sendu aðeins það sem eiginleikinn þarf.

Gátlisti

• Aðskilin OpenAI-verkefni (eða lyklar) fyrir prófun og framleiðslu
• Lykill geymdur sem leyndarmál á netþjóni, aldrei í kóða í vafra eða geymslunni
• Tilkynningar um eyðslu og hart eyðslumark sett
• Allar köll fara í gegnum þinn netþjón og athuga heimildir notandans
• Lengd úttaks takmörkuð; heiti líkans er stillanlegt
• Takmörkun á hvern notanda í appinu þínu
• 429-meðhöndlun með Retry-After, bið og slembitöf
• Vinaleg villustaða; síðan virkar án AI
• Táknnotkun skráð fyrir hvern eiginleika
• Prófað með löngum, tómum og fjandsamlegum inntökum

Að nota OpenAI API í Mythex

AI-eiginleikar í öppum sem þú smíðar á Mythex nota þinn eigin OpenAI-lykil, sem er reiknaður á OpenAI-reikninginn þinn en ekki á Mythex-smíðiseiningar. Bættu OPENAI_API_KEY við sem leyndarmál verkefnisins í gegnum /secrets, stillingar verkefnisins eða leyndarmálaspjaldið sem agentinn sýnir þegar hann þarf lykil, og lýstu síðan eiginleikanum með fyrirmælum eins og þeim hér að ofan. Eftir að þú breytir leyndarmálum í birtu appi skaltu birta aftur svo það nái í þau. Uppskriftin í skjölunum Bættu AI-eiginleikum við með þínum eigin API-lyklum hefur upphafsfyrirmæli, og Leyndarmál í spjalli útskýrir leyndarmálaspjaldið. Ertu að bera saman þjónustuaðila? Sjá hvernig þú tengir Claude API.

Spurningar