Salt la conținutul principal
Română— Alege o limbă
Meniu

Autentificare, chei API și organizare

Lecția 3 din 22 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Autentificare, chei API și organizare
  2. Crearea contului și obținerea unei chei
  3. Ce tip de cheie să alegeți
  4. Organizații și proiecte
  5. Nu expuneți niciodată cheile
  6. Verificarea configurației
  7. Puncte cheie

Autentificare, chei API și organizare

Înainte de a scrie prima linie de cod, trebuie să configurați accesul la API. Această lecție acoperă crearea cheilor, structurarea accesului prin organizații și proiecte, precum și măsurile de securitate care previn coșmarul clasic: împingerea accidentală a unei chei într-un depozit public, unde un străin o poate consuma peste noapte.

Crearea contului și obținerea unei chei

Procesul implică trei pași. În primul rând, accesați platform.openai.com și creați un cont; veți primi automat credite gratuite pentru a începe experimentarea. Apoi, navigați la secțiunea API Keys din panoul de control și generați o nouă cheie. Veți vedea această cheie o singură dată: copiați-o imediat, dar nu o lipiți în codul dumneavoastră.

# Cheia API arată astfel (nu o partajați niciodată!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Cea mai bună practică: utilizați o variabilă de mediu
import os
api_key = os.environ.get("OPENAI_API_KEY")

Al treilea pas este declararea variabilei de mediu, care depinde de platforma dumneavoastră. Pe o mașină de dezvoltare, un fișier .env încărcat de python-dotenv este adesea cea mai convenabilă soluție. Pe un server, preferați o variabilă de mediu definită de orchestrator sau de serviciul de secrete.

# Linux / macOS — adăugați în ~/.bashrc sau ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"

# Fișier .env (cu python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Ce tip de cheie să alegeți

Cheile de proiect, identificabile prin prefixul lor sk-proj-, sunt legate de un proiect specific și oferă cel mai bun control. Le veți utiliza în aproape toate cazurile. SDK-ul le detectează automat odată ce variabila de mediu este setată, motiv pentru care OpenAI() se instanțiază fără argumente în toate exemplele din acest curs.

from openai import OpenAI

# SDK detectează automat OPENAI_API_KEY
client = OpenAI()

# Sau specificați explicit (nu este recomandat pentru producție)
client = OpenAI(api_key="sk-proj-...")

Cheile de serviciu sunt al doilea tip. Concepute pentru aplicații server care necesită acces ridicat, acestea acordă permisiuni suplimentare și, prin urmare, cer o atenție sporită: stocați-le într-un seif de secrete și nu distribuiți niciodată valoarea lor unei stații de lucru de dezvoltare.

Organizații și proiecte

Accesul este structurat pe trei niveluri imbricate:

  1. Organizație: Compania sau echipa dumneavoastră
  2. Proiect: O grupare logică (de exemplu, „Chatbot de producție“, „Analiză de date“)
  3. Cheie API: Legată de un proiect specific

Dacă faceți parte din mai multe organizații, specificați-o pe cea pe care intenționați să o utilizați la instanțierea clientului:

from openai import OpenAI

# Specificați organizația (util dacă aparțineți mai multora)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Luați-vă timp pentru a vă diviza utilizarea în proiecte, în loc să direcționați totul printr-o singură cheie. Veți vedea beneficiul la primul semn de dificultate. Fiecare proiect are propria sa urmărire a utilizării, permițându-vă să atribuiți costurile unei funcționalități specifice, mai degrabă decât unui total lunar opac. Limitele de rată sunt, de asemenea, separate: o lucrare batch nocturnă care își saturează cota nu va împiedica chatbot-ul dumneavoastră să răspundă clienților. Puteți apoi atribui diferiți membri fiecărui proiect și, crucial, puteți revoca o cheie compromisă fără a întrerupe alte aplicații.

Nu expuneți niciodată cheile

Regula este simplă și absolută: o cheie nu apare niciodată în codul sursă. Contrastul dintre cele două fragmente de mai jos spune mai mult decât o lungă prelegere.

# RĂU — cheie hardcoded în cod
client = OpenAI(api_key="sk-proj-abc123")  # PERICOL!

# BINE — variabilă de mediu
client = OpenAI()  # Citește automat OPENAI_API_KEY

# BINE — fișier .env cu python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Corolarul se referă la fișierul .gitignore, care trebuie să excludă fișierele de configurare locale înainte de primul commit, nu după. O cheie care este publicată și apoi ștearsă rămâne prezentă în istoricul depozitului.

# Adăugați ÎNTOTDEAUNA aceste linii în .gitignore
.env
.env.local
.env.production
*.key

În final, planificați o rotație regulată, la fiecare 90 de zile. Puteți face acest lucru fără timp de inactivitate: creați o nouă cheie, actualizați implementările și apoi ștergeți vechea cheie doar după ce nimic nu o mai utilizează.

Verificarea configurației

Înainte de a continua, rulați acest script. Acesta verifică prezența cheii, afișează o versiune trunchiată pentru a confirma că este cea corectă și apoi efectuează un apel real. Rerulați acest test ori de câte ori un mediu se comportă ciudat.

from openai import OpenAI
import os

def verify_configuration():
    """Verifică dacă configurația API este corectă."""
    
    # Verifică prezența cheii
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("EROARE: OPENAI_API_KEY nu este definită")
        return False
    
    print(f"Cheie detectată: {api_key[:8]}...{api_key[-4:]}")
    
    # Testează conexiunea
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Conexiune reușită: {response.output_text}")
        return True
    except Exception as e:
        print(f"EROARE de conexiune: {e}")
        return False

verify_configuration()
# Rezultat așteptat:
# Cheie detectată: sk-proj-...xxxx
# Conexiune reușită: OK

Puncte cheie

  • Utilizați chei de proiect (sk-proj-...) pentru fiecare aplicație
  • Stocați cheile în variabile de mediu, niciodată în cod
  • Organizați accesul folosind ierarhia Organizație → Proiect → Cheie
  • Efectuați rotația regulată a cheilor (la fiecare 90 de zile)
  • Adăugați întotdeauna .env în fișierul .gitignore