Update README.md

README.md

@@ -1,10 +1,87 @@
 ---
-title: API
-emoji: 📈
+title: CygnisAI Studio API
+emoji: 🦢
 colorFrom: purple
 colorTo: indigo
 sdk: docker
 pinned: false
+app_port: 7860
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🦢 CygnisAI Studio API
+
+Une API unifiée et performante pour accéder aux meilleurs modèles d'IA open-source via l'infrastructure Hugging Face.
+
+Cette API agit comme une passerelle sécurisée et intelligente, routant vos requêtes vers les modèles les plus adaptés (Llama 3, Gemma 2, DeepSeek, etc.) avec une interface compatible OpenAI.
+
+## 🚀 Fonctionnalités
+
+- **Multi-modèles** : Accès à une large gamme de LLMs via un seul endpoint.
+- **Sécurisé** : Authentification par Bearer Token.
+- **Standardisé** : Format de requête et de réponse JSON simple.
+- **Robuste** : Gestion automatique des erreurs et fallbacks.
+
+## 🛠️ Utilisation
+
+### Endpoint Principal
+
+`POST /api/ask`
+
+### Authentification
+
+Ajoutez le header suivant à vos requêtes :
+`Authorization: Bearer VOTRE_CLE_API`
+
+*(La clé par défaut pour la démo est : `cgn_live_stable_demo_api_key_012345`)*
+
+### Exemple de Requête (JavaScript / Fetch)
+
+```javascript
+fetch('https://votre-space-url.hf.space/api/ask', {
+  method: 'POST',
+  headers: {
+    'Authorization': 'Bearer cgn_live_stable_demo_api_key_012345',
+    'Content-Type': 'application/json',
+  },
+  body: JSON.stringify({
+    question: 'Qui a découvert la pénicilline ?',
+    model: 'google/gemma-3-27b-it', // Optionnel
+    system_prompt: 'Tu es un expert en histoire des sciences.' // Optionnel
+  }),
+})
+.then(response => response.json())
+.then(data => console.log(data));
+```
+
+### Exemple de Réponse
+
+```json
+{
+  "answer": "La pénicilline a été découverte par Alexander Fleming en 1928...",
+  "model_used": "google/gemma-2-27b-it",
+  "sources": []
+}
+```
+
+## 🤖 Modèles Disponibles
+
+Vous pouvez demander ces modèles via le paramètre `model`. L'API routera automatiquement vers la version la plus performante disponible.
+
+| ID du Modèle (Alias) | Modèle Réel Utilisé (Fallback) | Description |
+|---|---|---|
+| `google/gemma-3-27b-it` | Gemma 2 27B IT | Rapide et efficace |
+| `openai/gpt-oss-120b` | Llama 3.1 70B | Très puissant, équivalent GPT-4 |
+| `deepseek-ai/DeepSeek-V3.2` | DeepSeek V3 | Excellent pour le code et la logique |
+| `meta-llama/Llama-4-Scout` | Llama 3.1 8B | Léger et ultra-rapide |
+| `nvidia/Nemotron-3` | Llama 3.1 Nemotron 70B | Spécialisé instruction-following |
+| `default` | Llama 3 8B | Le choix par défaut équilibré |
+
+## ⚙️ Configuration (Pour le déploiement)
+
+Pour déployer cette API sur votre propre Space, vous devez configurer les **Secrets** suivants dans les paramètres du Space :
+
+1.  `HF_TOKEN` : Votre token d'accès Hugging Face (avec droits de lecture).
+2.  `CYGNIS_API_KEY` : (Optionnel) La clé API que vous souhaitez utiliser pour sécuriser l'accès.
+
+---
+*Propulsé par FastAPI, Docker et l'Inference API Hugging Face.*