Quickstart
Effectuez votre premier appel API en moins de 5 minutes.
Prérequis
- Un compte GenesisAI (gratuit)
- Une clé API active
- cURL ou un client HTTP de votre choix
1
Créer un compte
Si vous n'avez pas encore de compte, inscrivez-vous gratuitement sur notre plateforme. Vous recevrez automatiquement 100 crédits gratuits pour tester l'API.
Créer un compte gratuit2
Générer une clé API
Accédez à votre dashboard et créez une nouvelle clé API. Conservez cette clé précieusement, elle ne sera affichée qu'une seule fois.
Important
Ne partagez jamais votre clé API. Ne l'incluez pas dans votre code côté client ou dans des dépôts publics.
3
Tester l'API
Vérifiez que votre clé API fonctionne en appelant l'endpoint de santé :
Vérifier la connexion
bashcurl https://api.genesisai.fr/v1/health \
-H "Authorization: Bearer YOUR_API_KEY"Vous devriez recevoir une réponse comme :
{
"status": "ok",
"version": "1.0.0",
"credits": 100
}4
Premier appel : Transcription
Transcrivez un fichier audio en texte :
Transcription audio
bashcurl -X POST https://api.genesisai.fr/v1/transcribe \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@votre_audio.mp3" \
-F "language=fr"Réponse :
{
"success": true,
"data": {
"text": "Bonjour, ceci est un exemple de transcription...",
"language": "fr",
"duration": 12.5,
"words": [
{ "word": "Bonjour", "start": 0.0, "end": 0.5, "confidence": 0.98 },
{ "word": "ceci", "start": 0.6, "end": 0.8, "confidence": 0.95 }
]
},
"credits_used": 2,
"credits_remaining": 98
}5
Générer un plan
Créez un plan structuré à partir d'un sujet :
Génération de plan
bashcurl -X POST https://api.genesisai.fr/v1/plans/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"topic": "Guide complet du marketing digital",
"type": "detailed",
"sections": 5
}'Réponse :
{
"success": true,
"data": {
"title": "Guide complet du marketing digital",
"sections": [
{
"title": "1. Introduction au marketing digital",
"subsections": [
"1.1 Définition et enjeux",
"1.2 Évolution du paysage digital"
]
},
{
"title": "2. Stratégies de contenu",
"subsections": [
"2.1 Content marketing",
"2.2 SEO et référencement"
]
}
]
},
"credits_used": 3,
"credits_remaining": 95
}Utiliser un SDK
Pour une intégration plus facile, utilisez nos SDK officiels :
JavaScript / TypeScript
npm install @genesisai/sdkimport { GenesisAI } from '@genesisai/sdk';
const client = new GenesisAI('YOUR_API_KEY');
// Transcription
const result = await client.transcribe({
file: audioFile,
language: 'fr'
});
console.log(result.text);Python
pip install genesisaifrom genesisai import GenesisAI
client = GenesisAI("YOUR_API_KEY")
# Transcription
result = client.transcribe(
file="audio.mp3",
language="fr"
)
print(result.text)