|
|
--- |
|
|
title: CygnisAI Studio API |
|
|
emoji: 🦢 |
|
|
colorFrom: purple |
|
|
colorTo: indigo |
|
|
sdk: docker |
|
|
pinned: false |
|
|
app_port: 7860 |
|
|
--- |
|
|
|
|
|
# 🦢 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.* |
|
|
|
