---
title: IA Génération d'images
emoji: 🎨
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 5.50.0
app_file: app.py
pinned: false
---

# Atelier IA — page de classe (fal.ai)

Page web pour que les étudiants génèrent des images avec **vos** crédits fal.ai, sans jamais voir la clé API.

- **Texte → Image** : Krea 2 Turbo, Z-Image Turbo + templates de prompts (CSV)
- **Image → Image** : Nano Banana 2 (édition), Seedream 5 Pro (édition), 1 à 4 images de référence
- **Ma galerie** : images de l'étudiant, prompt, réutilisation comme référence, export .zip (avec `prompts.csv`)
- **Enseignant** : crédits par étudiant, quota, remise à zéro, import des templates de classe, galeries des étudiants

## Connexion

- **Étudiant** : identifiant = son prénom (ou pseudo), mot de passe = le code de classe (`CLASS_CODE`)
- **Enseignant** : identifiant `prof`, mot de passe `ADMIN_CODE` → l'onglet « Enseignant » apparaît

Chaque identifiant a sa propre galerie : les étudiants doivent toujours utiliser le même.

## Crédits

Chaque étudiant a un quota (60 crédits par défaut, modifiable dans l'onglet Enseignant).
Texte → Image = 1 crédit/image, édition = 4 crédits/image (réglable dans `app.py`, dictionnaires `T2I_MODELS` / `I2I_MODELS`).
Les images bloquées par le filtre de sécurité ne sont pas décomptées.
Côté fal.ai, ne rechargez que le budget prévu : le solde ne peut pas passer en négatif.

## Option A — Hugging Face Spaces (en ligne, gratuit)

1. Sur huggingface.co : **New Space** → SDK **Gradio** → matériel **CPU basic (gratuit)** → visibilité **Public**
   (l'accès reste protégé par le code de classe ; un Space privé n'est accessible qu'aux comptes autorisés).
2. Onglet **Files** → *Upload files* : `app.py`, `requirements.txt`, `templates_exemple.csv`, `README.md`.
3. **Settings → Variables and secrets** → *New secret* :
   - `FAL_KEY` = votre clé fal.ai
   - `CLASS_CODE` = code de la classe
   - `ADMIN_CODE` = votre mot de passe enseignant
   - (optionnel) `QUOTA` = 60
4. **Sauvegarde des galeries (recommandé)** : le disque d'un Space gratuit est effacé à chaque redémarrage.
   Ajoutez aussi les secrets `HF_TOKEN` (jeton *Write* créé dans Settings → Access Tokens de votre compte)
   et `DATA_REPO` = `votre-nom/atelier-ia-data`. Les galeries sont copiées toutes les 2 min dans un dataset
   privé et restaurées au redémarrage.
5. Donnez aux étudiants l'adresse **directe** du Space : `https://votre-nom-nom-du-space.hf.space`
   (la connexion fonctionne mal dans la page huggingface.co/spaces/… à cause des cookies).

Un Space gratuit se met en veille après 48 h sans visite : ouvrez-le quelques minutes avant le cours.

## Option B — Sur votre PC pendant le cours

1. Installez Python 3.10+ (cochez « Add Python to PATH »).
2. Ouvrez `lancer_windows.bat` avec le Bloc-notes, remplissez `FAL_KEY`, `CLASS_CODE`, `ADMIN_CODE`, enregistrez.
3. Double-cliquez dessus. Les étudiants sur le même Wi-Fi ouvrent `http://<IP de votre PC>:7860`
   (IP donnée par la commande `ipconfig`). Autorisez Python dans le pare-feu Windows si demandé.
4. Les images restent dans le dossier `data/`.

## Format des templates CSV

Colonnes `categorie`, `titre`, `prompt` — séparateur `;` ou `,`, UTF-8 ou export Excel.
Voir `templates_exemple.csv` (14 templates animation 2D, chargés automatiquement au premier lancement).
L'import dans l'onglet Enseignant remplace les templates de classe.
Les étudiants peuvent importer leurs propres templates (marqués ★, visibles d'eux seuls).