# Bien démarrer

Vérifiez la connexion en mode Test avant d’intégrer l’API au produit

Canonical: https://alef-bot.top/fr/developers/guides/get-started

Updated: 2026-07-13

## Avant de commencer

- Un compte AlefBot Premium ou Platinum
- Une clé Test créée dans les paramètres API. Ce mode vérifie la connexion sans traiter de vrais médias
- Un agent IA capable de lire le projet et d’exécuter des commandes, ou un chat qui prépare le code

- [Créer une clé Test](/dashboard?modal=settings&tab=public-api) — Créez une clé Test et conservez-la en lieu sûr
- [Référence API](/fr/developers/api-reference) — Consultez les opérations, paramètres, réponses et exemples de requêtes

## Garder la clé hors du chat

> **La clé API est un secret.** Stockez-la dans la variable d’environnement `ALEFBOT_API_KEY`. Ne la collez jamais dans un chat, du code, une URL, des journaux ou des outils d’analyse

La consigne de la page d’accueil indique les spécifications à lire et l’usage sûr de la clé. L’agent doit la lire dans l’environnement sans l’afficher

## Exécuter un test isolé

1. **Copier la consigne.** Sur la page d’accueil, cliquez sur Copier la consigne et transmettez-la à l’agent dans votre projet
2. **L’agent lit les spécifications API.** Avant de modifier le code, l’agent lit llms.txt, OpenAPI et le workflow Arazzo
3. **Exécuter le mode Test.** L’agent crée un petit test séparé pour Téléverser → Transcrire → Suivre → Télécharger, sans traiter de vrais médias
4. **Vérifier le rapport.** L’agent indique les fichiers modifiés, les commandes exécutées et les résultats sans afficher la clé

## Confirmer la réussite du test

- Le workflow Test a produit le résultat prévu par la documentation
- Aucun média réel n’a été téléversé ou traité
- La clé n’a été ni enregistrée dans le code, ni affichée, ni envoyée au chat
- La modification reste isolée et n’affecte pas encore le produit

> **Après la réussite seulement.** Demandez à l’agent une intégration minimale au produit. Le mode Live et les médias réels nécessitent une décision explicite et une clé adaptée

## Consulter la documentation technique

- [Référence API](/fr/developers/api-reference) — Consultez les opérations, paramètres, réponses et exemples de requêtes
- [llms.txt](/fr/developers/llms.txt) — Orientez votre agent IA ici pour trouver les guides et spécifications utiles

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)