Si ta integroni OpenAI API në aplikacionin tuaj

Për të integruar OpenAI API, krijoni një çelës API në një projekt OpenAI, ruajeni si sekret në server me emrin OPENAI_API_KEY, dhe thirrni API nga një rrugë në serverin tuaj duke përdorur SDK-në zyrtare të OpenAI, kurrë nga kodi i shfletuesit. Që nga shtatori 2026, quickstart-i i OpenAI e paraqet Responses API si pikën e nisjes për projektet e reja. Vendosni një kufi shpenzimesh përpara lançimit, kufizoni gjatësinë e përgjigjes, kufizoni sa herë mund ta thërrasë çdo përdorues veçorinë dhe trajtoni gabimet e kufirit me riprova.

Ky udhëzues mbulon konfigurimin, rrjedhën e kërkesës, udhëzime për një AI builder dhe gabimet që rrjedhin çelësa ose shpenzojnë para. Detajet e OpenAI janë nga dokumentacioni zyrtar që nga shtatori 2026. Për konceptet e përgjithshme (tokenët, dritaret e kontekstit, çmimet), lexoni fillimisht si të përdorni LLM API.

Çfarë mund të ndërtoni me të

Një asistent bisede brenda aplikacionit tuaj (si të ndërtoni një aplikacion chatbot me AI)
Butona „Përmblidh këtë", „Rishkruaj këtë" ose „Harto një përgjigje"
Nxjerrje të dhënash të strukturuara nga tekst i lirë: kthimi i një email-i në porosi, etiketimi i biletave të mbështetjes
Kërkim dhe përgjigje pyetjesh mbi përmbajtjen tuaj
Veçori imazhi, zëri dhe media të tjera, varësisht nga modelet e disponueshme

Më shumë ide gjenden te si të shtoni veçori AI në aplikacionin tuaj.

Konfigurimi i llogarisë OpenAI

Krijoni një llogari dhe një projekt në platformën e OpenAI. Praktikat e prodhimit të OpenAI rekomandojnë projekte të veçanta për staging dhe prodhim, që secili të ketë çelësat dhe kufijtë e vet.
Krijoni një çelës API projekti. OpenAI rekomandon vendosjen e një date skadimi dhe rrotullimin e çelësave rregullisht.
Vendosni alarme shpenzimesh dhe një kufi të fortë shpenzimesh në faqen e kufijve. Udhëzuesi i OpenAI thotë se alarmet ju njoftojnë kur përdorimi kalon një shumë, dhe kufiri i fortë zbaton një tavan mujor.
Shtoni faturimin. Dokumentacioni i kufijve të OpenAI përshkruan nivele përdorimi: kufijtë tuaj rriten automatikisht ndërsa shpenzoni më shumë me kalimin e kohës.

Rrjedha e kërkesës

Shfletuesi  ->  rruga juaj në server  ->  OpenAI API
            <-  (përgjigje e transmetuar)  <-

Përdoruesi klikon një buton ose dërgon një mesazh.
Shfletuesi thërret rrugën tuaj në server, për shembull POST /api/summarise.
Serveri juaj kontrollon që përdoruesi është i kyçur dhe i lejuar të përdorë veçorinë.
Serveri ndërton kërkesën: udhëzimet, input-in e përdoruesit dhe çdo të dhënë nga baza juaj që detyra kërkon.
Thërret OpenAI me çelësin nga mjedisi. SDK-të e OpenAI e lexojnë OPENAI_API_KEY automatikisht.
Transmeton ose kthen përgjigjen dhe regjistron përdorimin e tokenëve.

Paketat zyrtare SDK të OpenAI quhen openai si për JavaScript/TypeScript (npm) ashtu edhe për Python (pip).

Zgjedhja e modelit

OpenAI ofron disa modele me çmime dhe shpejtësi të ndryshme, dhe lista ndryshon shpesh. Filloni me një model më të vogël dhe më të lirë, matni cilësinë me shembuj reale dhe kaloni më lart vetëm nëse ju duhet. Mbani emrin e modelit në një vlerë konfigurimi ose sekret, që ta ndryshoni pa rishkruar kodin. Shihni faqen e çmimeve të OpenAI për tarifat aktuale.

Opsionet dhe kompromiset

Vendimi	Zgjedhja e thjeshtë	Kur të shkoni më tej
Streaming	Ktheni përgjigjen e plotë	Përdorni streaming për bisedë dhe përgjigje të gjata; përdoruesit shohin tekstin menjëherë
Memoria e bisedës	Dërgoni mesazhet e fundit çdo herë	Përmblidhni mesazhet e vjetra kur bisedat zgjaten
Formati i daljes	Tekst i thjeshtë	Kërkoni JSON të strukturuar kur kodi juaj duhet të lexojë fusha
Të dhënat tuaja	Përfshini regjistrimin përkatës në kërkesë	Shtoni kërkim mbi përmbajtjen tuaj kur ka shumë për të përfshirë (shihni çfarë është RAG)
Punë masive, jo urgjente	Cikël mbi elementet	Përdorni opsionin batch të OpenAI për kosto më të ulët kur rezultatet presin

Udhëzime për t'i dhënë AI builder-it tuaj

Një veçori e parë:

Shtoni një buton „Përmblidh" në faqen e biletës. Ai thërret një rrugë serveri POST /api/summarise që kontrollon që përdoruesi është i kyçur, ngarkon biletën dhe thërret OpenAI Responses API me SDK-në zyrtare openai dhe sekretin OPENAI_API_KEY. Lexo emrin e modelit nga sekreti OPENAI_MODEL. Udhëzimet: "Përmblidh në 3 pika, pastaj sugjero një përgjigje të shkurtër. Mos shpik numra porosish." Kufizo gjatësinë e daljes, transmeto përgjigjen te faqja dhe mos e dërgo kurrë çelësin te shfletuesi.

Mbrojtjet:

Kufizo çdo përdorues në 30 kërkesa AI në orë, të ruajtura në bazën e të dhënave. Regjistro tokenët hyrës dhe dalës me ID-në e përdoruesit dhe emrin e veçorisë. Nëse OpenAI kthen 429, respekto header-in Retry-After dhe riprovo me backoff eksponencial dhe jitter deri në 3 herë; pas kësaj, shfaq "AI është i zënë, provo përsëri pas një minute." Shfaq një gabim të sjellshëm për çdo dështim tjetër dhe mbaje pjesën tjetër të faqes të punojë.

Trajtimi i gabimeve dhe kufijve

OpenAI mat kufijtë e shpejtësisë në disa mënyra, përfshirë kërkesat në minutë dhe tokenët në minutë, dhe e arrini atë që mbaron të parën. Kur e kaloni një nga ata, API kthen një 429 me header-in Retry-After. Dokumentacioni i OpenAI thotë ta trajtoni atë vlerë si minimum dhe të shtoni një vonesë të vogël të rastësishme, që klientët të mos riprovojnë të gjithë njëkohësisht.

Gjithashtu planifikoni për:

Afatet kohore në gjenerime të gjata. Streaming ndihmon, dhe ndihmon edhe një kufi i arsyeshëm i daljes.
Ndërprerje të ofruesit. Veçoria AI duhet të dështojë me hir pa e prishur faqen.
Dalje e keqe. Validoni daljen e strukturuar përpara ruajtjes, dhe mos lejoni që dalja e modelit të nxisë veprime të ndjeshme pa një kontroll në kodin tuaj.

Gabimet e zakonshme

Çelësi në frontend ose në repository. Kodi i shfletuesit është publik, dhe një çelës i rrjedhur mund të keqpërdoret brenda minutash. Shihni si t'i mbani të sigurta çelësat API.
Pa kufi shpenzimesh. Një lak ose një përdorues abuzues mund të rrisë shpejt një faturë të madhe.
Pa kufij për përdorues. Kufiri i ofruesit mbron portofolin tuaj, jo përdoruesit e tjerë.
Besimi te prompt-i për sigurinë. Përdoruesit mund të shkruajnë „injoro udhëzimet e mëparshme". Lejet i takojnë kodit të serverit.
Dërgimi më tepër sesa nevojitet. Dokumentet e plota dhe historitë e gjata shumëzojnë koston. Dërgoni vetëm atë që kërkon detyra.
Harduakodimi i emrit të modelit. Modelet përditësohen dhe hiqen; bëjeni një cilësim.
Dërgimi i të dhënave personale pa menduar. Lexoni kushtet e përdorimit të të dhënave të OpenAI dhe dërgoni vetëm atë që ka nevojë veçoria.

Lista e kontrollit

Projekte OpenAI (ose çelësa) të veçantë për testim dhe prodhim
Çelësi i ruajtur si sekret në server, jo në kodin e shfletuesit ose në repo
Alarme shpenzimesh dhe kufi i fortë shpenzimesh të vendosur
Të gjitha thirrjet kalojnë përmes serverit tuaj dhe kontrollojnë lejet e përdoruesit
Gjatësia e daljes e kufizuar; emri i modelit i konfigurueshëm
Kufi shpejtësie për përdorues në aplikacionin tuaj
Trajtimi i 429 me Retry-After, backoff dhe jitter
Gjendje e sjellshme gabimi; faqja punon edhe pa AI
Tokenët e përdorura të regjistruara për çdo veçori
Testuar me inpute të gjata, bosh dhe armiqësore

Përdorimi i OpenAI API në Mythex

Veçoritë AI në aplikacionet që ndërtoni në Mythex përdorin çelësin tuaj OpenAI, të faturuar në llogarinë tuaj OpenAI, jo në kreditet e ndërtimit të Mythex. Shtoni OPENAI_API_KEY si sekret projekti përmes /secrets, cilësimeve të projektit ose kartës së sekreteve që agjenti shfaq kur i duhet një çelës, pastaj përshkruani veçorinë me një prompt si ato më lart. Pasi ndryshoni sekretet në një aplikacion të publikuar, publikojeni përsëri që të marrë ndryshimet. Recetë e dokumentacionit Shto veçori AI me çelësat e tu API ka një prompt fillestar, dhe Sekretet në bisedë shpjegon kartën e sekreteve. Po krahasoni ofrues? Si të integroni Claude API mbulon të njëjtën gjë për Claude.

Pyetje

Cilin OpenAI API duhet të përdor për një aplikacion të ri?

Që në shtator 2026, quickstart-i zyrtar i OpenAI e paraqet Responses API si pikën e nisjes për projektet e reja, me shembuj që përdorin client.responses.create() në SDK-të zyrtare. Kontrolloni dokumentacionin e OpenAI për rekomandimin aktual përpara se të filloni.

A mund ta thërras OpenAI API nga shfletuesi?

Jo me çelësin tuaj sekret. Kushdo mund ta lexojë kodin e shfletuesit dhe të përdorë përsëri çelësin për të rritur faturën tuaj. Shfletuesi duhet të thërrasë rrugën e serverit tuaj, dhe serveri thërret OpenAI me çelësin të ruajtur si variabël mjedisi.

Si e ndaloj OpenAI API të kushtojë shumë?

Udhëzuesi i prodhimit i OpenAI rekomandon alarme shpenzimesh dhe një kufi të fortë shpenzimesh mujore në faqen e kufijve. Në aplikacionin tuaj, kufizoni gjatësinë e përgjigjes, kufizoni kërkesat për çdo përdorues dhe regjistroni përdorimin e tokenëve, që të shihni cilat veçori kushtojnë më shumë.

Çfarë do të thotë një gabim 429 nga OpenAI?

Do të thotë se keni arritur një kufi shpejtësie. Dokumentacioni i OpenAI thotë se përgjigjja përfshin header-in Retry-After; prisni të paktën aq, shtoni një vonesë të vogël të rastësishme dhe riprovoni me backoff eksponencial.