Cum integrezi OpenAI API în aplicația ta

Pentru a integra OpenAI API, creează o cheie API într-un proiect OpenAI, salveaz-o ca secret pe server numit OPENAI_API_KEY și apelează API-ul dintr-o rută de pe propriul tău server, folosind SDK-ul oficial OpenAI, niciodată din codul din browser. Din septembrie 2026, ghidul de pornire rapidă OpenAI prezintă Responses API ca punct de plecare pentru proiectele noi. Setează o limită de cheltuieli înainte de lansare, limitează lungimea răspunsurilor, restricționează de câte ori poate fiecare utilizator să apeleze funcția și tratează erorile de limită de rată cu reîncercări.

Acest ghid acoperă configurarea, fluxul cererilor, prompturi pentru un constructor de aplicații cu AI și greșelile care scurg chei sau consumă bani. Detaliile OpenAI sunt din documentația oficială din septembrie 2026. Pentru conceptele generale (tokeni, ferestre de context, prețuri), citește mai întâi cum să folosești API-urile LLM.

Ce poți construi cu el

• Un asistent de chat în interiorul aplicației tale (cum să construiești o aplicație chatbot cu AI)
• Butoane de tip „Rezumă asta”, „Rescrie asta” sau „Redactează un răspuns”
• Extragerea de date structurate din text liber: transformarea unui email într-o comandă, etichetarea tichetelor de suport
• Căutare și răspunsuri la întrebări pe baza propriului conținut
• Funcții de imagini, voce și alte media, în funcție de modelele disponibile

Mai multe idei sunt în cum să adaugi funcții AI în aplicația ta.

Configurarea contului OpenAI

1. Creează un cont și un proiect în platforma OpenAI. Cele mai bune practici de producție ale OpenAI recomandă proiecte separate pentru staging și producție, ca fiecare să aibă propriile chei și limite.
2. Creează o cheie API de proiect. OpenAI recomandă setarea unei date de expirare și rotirea regulată a cheilor.
3. Setează alerte de cheltuieli și o limită fermă de cheltuieli pe pagina de limite. Ghidul OpenAI spune că alertele te anunță când utilizarea depășește o sumă, iar o limită fermă impune un plafon lunar.
4. Adaugă plata. Documentația OpenAI privind limitele de rată descrie niveluri de utilizare: limitele tale cresc automat pe măsură ce cheltuiești mai mult în timp.

Fluxul cererii

Browser  ->  ruta ta de server  ->  OpenAI API
         <-  răspuns (în flux)  <-

1. Utilizatorul apasă un buton sau trimite un mesaj.
2. Browserul apelează ruta ta, de exemplu POST /api/summarise.
3. Serverul tău verifică dacă utilizatorul este autentificat și are voie să folosească funcția.
4. Serverul construiește cererea: instrucțiuni, intrarea utilizatorului și orice date din baza ta necesare task-ului.
5. Apelează OpenAI cu cheia din mediu. SDK-urile OpenAI citesc automat OPENAI_API_KEY.
6. Transmite în flux sau returnează răspunsul și înregistrează consumul de tokeni.

Pachetele SDK oficiale OpenAI se numesc openai atât pentru JavaScript/TypeScript (npm), cât și pentru Python (pip).

Alegerea unui model

OpenAI oferă mai multe modele la prețuri și viteze diferite, iar gama se schimbă des. Începe cu un model mai mic și mai ieftin, măsoară calitatea pe exemple reale și treci la unul mai mare doar dacă ai nevoie. Păstrează numele modelului într-o valoare de configurare sau într-un secret, ca să-l poți schimba fără să rescrii codul. Verifică pagina de prețuri OpenAI pentru tarifele actuale.

Opțiuni și compromisuri

Prompturi pentru constructorul tău de AI

O primă funcție:

Adaugă un buton „Rezumă” pe pagina tichetului. Apelează o rută de server POST /api/summarise care verifică dacă utilizatorul este autentificat, încarcă tichetul și apelează OpenAI Responses API folosind SDK-ul oficial openai și secretul OPENAI_API_KEY. Citește numele modelului din secretul OPENAI_MODEL. Instrucțiuni: „Rezumă în 3 puncte, apoi sugerează un răspuns scurt. Nu inventa numere de comenzi.” Limitează lungimea ieșirii, transmite răspunsul în flux către pagină și nu trimite niciodată cheia în browser.

Protecții:

Limitează fiecare utilizator la 30 de cereri AI pe oră, stocate în baza de date. Înregistrează tokenii de intrare și de ieșire pentru fiecare cerere, cu ID-ul utilizatorului și numele funcției. Dacă OpenAI returnează 429, respectă antetul Retry-After și reîncearcă cu backoff exponențial și jitter, de până la 3 ori; după aceea, afișează „AI-ul este ocupat, încearcă din nou peste un minut.” Afișează o eroare prietenoasă pentru orice alt eșec și păstrează restul paginii funcțional.

Gestionarea erorilor și a limitelor

OpenAI măsoară limitele de rată în mai multe moduri, inclusiv cereri pe minut și tokeni pe minut, iar tu atingi cea care se epuizează prima. Când depășești una, API-ul returnează un 429 cu un antet Retry-After. Documentația OpenAI spune să tratezi această valoare ca pe un minim și să adaugi o mică întârziere aleatorie, ca clienții să nu reîncerce toți odată.

Pregătește-te și pentru:

• Timeout-uri la generările lungi. Streaming-ul ajută, la fel și o limită rezonabilă a ieșirii.
• Întreruperi ale furnizorului. Funcția AI ar trebui să eșueze elegant, fără să strice pagina.
• Ieșire proastă. Validează ieșirea structurată înainte să o salvezi și nu lăsa ieșirea modelului să declanșeze acțiuni sensibile fără o verificare în codul tău.

Greșeli frecvente

• Cheia în frontend sau în repository. Codul din browser este public, iar o cheie scursă poate fi abuzată în câteva minute. Vezi cum să păstrezi în siguranță cheile API.
• Lipsa unei limite de cheltuieli. O buclă sau un utilizator abuziv poate consuma rapid o factură mare.
• Lipsa limitelor per utilizator. Limita furnizorului îți protejează portofelul, nu pe ceilalți utilizatori.
• Încrederea în prompt pentru securitate. Utilizatorii pot scrie „ignoră instrucțiunile anterioare”. Permisiunile aparțin codului de pe server.
• Trimiterea mai mult decât e nevoie. Documentele întregi și istoricele lungi înmulțesc costul. Trimite ce are nevoie task-ul.
• Scrierea numelui modelului direct în cod. Modelele sunt actualizate și retrase; transform-l într-o setare.
• Trimiterea de date personale fără gândire. Citește condițiile OpenAI privind utilizarea datelor și trimite doar ce are nevoie funcția.

Listă de verificare

• Proiecte OpenAI separate (sau chei separate) pentru testare și producție
• Cheie salvată ca secret pe server, niciodată în codul din browser sau în repository
• Alerte de cheltuieli și o limită fermă de cheltuieli setate
• Toate apelurile trec prin serverul tău și verifică permisiunile utilizatorului
• Lungimea ieșirii limitată; numele modelului este configurabil
• Limită de rată per utilizator în aplicația ta
• Tratarea erorii 429 cu Retry-After, backoff și jitter
• Stare de eroare prietenoasă; pagina funcționează fără AI
• Consumul de tokeni înregistrat per funcție
• Testat cu intrări lungi, goale și ostile

Folosirea OpenAI API în Mythex

Funcțiile AI din aplicațiile pe care le construiești pe Mythex folosesc propria ta cheie OpenAI, facturată în contul tău OpenAI, nu în creditele de construire Mythex. Adaugă OPENAI_API_KEY ca secret de proiect prin /secrets, din setările proiectului sau din cardul de secrete pe care îl arată agentul când are nevoie de o cheie, apoi descrie funcția cu un prompt ca cele de mai sus. După ce schimbi secretele unei aplicații publicate, publică din nou, ca aplicația să le preia. Rețeta din documentație Adaugă funcții AI cu propriile chei API are un prompt de pornire, iar Secretele în chat explică cardul de secrete. Compari furnizorii? Vezi cum să integrezi Claude API.

Întrebări