Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Authentification, clés API et organisation

Paskaita 3 iš 22 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Authentification, clés API et organisation
  2. Créer ton compte et obtenir une clé
  3. Quel type de clé choisir ?
  4. Organisations et projets
  5. Ne jamais exposer tes clés
  6. Vérifier ta configuration
  7. Svarbiausi punktai

Authentification, clés API et organisation

Avant d’écrire la moindre ligne de code, tu dois configurer ton accès à l’API. Cette leçon couvre la création de clés, la structuration des accès via les organisations et les projets, ainsi que les précautions de sécurité qui t’éviteront le cauchemar classique : pousser accidentellement une clé sur un dépôt public où un inconnu la consommera durant la nuit.

Créer ton compte et obtenir une clé

Le processus se déroule en trois étapes. Tout d’abord, rends-toi sur platform.openai.com et crée un compte ; tu recevras automatiquement des crédits gratuits pour commencer à expérimenter. Ensuite, navigue vers la section API Keys du tableau de bord et génère une nouvelle clé. Tu ne verras cette clé qu’une seule fois : copie-la immédiatement, mais ne la colle pas dans ton code.

# Ta clé API ressemble à ceci (ne la partage jamais !)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Meilleure pratique : utiliser une variable d'environnement
import os
api_key = os.environ.get("OPENAI_API_KEY")

La troisième étape consiste à déclarer la variable d’environnement, ce qui dépend de ta plateforme. Sur une machine de développement, un fichier .env chargé par python-dotenv est souvent le plus pratique. Sur un serveur, privilégie une variable d’environnement définie par ton orchestrateur ou ton service de secrets.

# Linux / macOS — à ajouter dans ~/.bashrc ou ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

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

# Fichier .env (avec python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Quel type de clé choisir ?

Les clés de projet, identifiables par leur préfixe sk-proj-, sont liées à un projet spécifique et offrent le meilleur contrôle. Tu les utiliseras dans presque tous les cas. Le SDK les détecte automatiquement une fois la variable d’environnement définie, c’est pourquoi OpenAI() s’instancie sans argument dans tous les exemples de ce cours.

from openai import OpenAI

# Le SDK détecte automatiquement OPENAI_API_KEY
client = OpenAI()

# Ou spécification explicite (non recommandé pour la production)
client = OpenAI(api_key="sk-proj-...")

Les clés de service constituent le second type. Conçues pour les applications serveur nécessitant un accès élevé, elles accordent des permissions supplémentaires et exigent donc une prudence accrue : stocke-les dans un coffre-fort de secrets et ne distribue jamais leur valeur sur un poste de travail de développement.

Organisations et projets

L’accès est structuré sur trois niveaux imbriqués :

  1. Organisation : Ton entreprise ou ton équipe
  2. Projet : Un regroupement logique (par ex. „Chatbot de production“, „Analyse de données“)
  3. Clé API : Liée à un projet spécifique

Si tu appartiens à plusieurs organisations, spécifie celle que tu souhaites utiliser lors de l’instanciation du client :

from openai import OpenAI

# Spécifier l'organisation (utile si tu appartiens à plusieurs)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Prends le temps de diviser ton utilisation en projets plutôt que de tout faire passer par une seule clé. Tu en verras le bénéfice dès les premiers signes de trouble. Chaque projet dispose de son propre suivi d’utilisation, te permettant d’attribuer les coûts à une fonctionnalité spécifique plutôt qu’à un total mensuel opaque. Les limites de débit sont également séparées : un travail par lots nocturne qui sature son quota n’empêchera pas ton chatbot de répondre aux clients. Tu peux ensuite assigner différents membres à chaque projet et, surtout, révoquer une clé compromise sans interrompre les autres applications.

Ne jamais exposer tes clés

La règle est simple et absolue : une clé n’apparaît jamais dans le code source. Le contraste entre les deux extraits ci-dessous est plus éloquent qu’un long discours.

# MAUVAIS — clé codée en dur dans le code
client = OpenAI(api_key="sk-proj-abc123")  # DANGER !

# BON — variable d'environnement
client = OpenAI()  # Lit automatiquement OPENAI_API_KEY

# BON — fichier .env avec python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Le corollaire concerne ton .gitignore, qui doit exclure les fichiers de configuration locaux avant ton premier commit, et non après. Une clé publiée puis supprimée reste présente dans l’historique du dépôt.

# AJOUTE TOUJOURS ces lignes à ton .gitignore
.env
.env.local
.env.production
*.key

Enfin, prévois une rotation régulière, tous les 90 jours. Tu peux le faire sans temps d’arrêt : crée une nouvelle clé, mets à jour tes déploiements, puis supprime l’ancienne uniquement lorsque plus rien ne l’utilise.

Vérifier ta configuration

Avant de poursuivre, exécute ce script. Il vérifie la présence de la clé, affiche une version tronquée pour confirmer qu’il s’agit de la bonne, puis effectue un appel réel. Réexécute ce test chaque fois qu’un environnement se comporte bizarrement.

from openai import OpenAI
import os

def verify_configuration():
    """Vérifie que la configuration de l'API est correcte."""
    
    # Vérifier la présence de la clé
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("ERREUR : OPENAI_API_KEY non définie")
        return False
    
    print(f"Clé détectée : {api_key[:8]}...{api_key[-4:]}")
    
    # Tester la connexion
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Connexion réussie : {response.output_text}")
        return True
    except Exception as e:
        print(f"ERREUR de connexion : {e}")
        return False

verify_configuration()
# Résultat attendu :
# Clé détectée : sk-proj-...xxxx
# Connexion réussie : OK

Svarbiausi punktai

  • Utilise des clés de projet (sk-proj-...) pour chaque application
  • Stocke tes clés dans des variables d’environnement, jamais dans le code
  • Organise ton accès avec la hiérarchie Organisation → Projet → Clé
  • Effectue une rotation régulière de tes clés (tous les 90 jours)
  • Ajoute toujours .env à ton .gitignore