Autentificare, chei API și organizare
Pe această pagină
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:
- Organizație: Compania sau echipa dumneavoastră
- Proiect: O grupare logică (de exemplu, „Chatbot de producție“, „Analiză de date“)
- 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