Bibliothèques client
Python
Support synchrone et asynchrone. Annotations de type complètes. Python 3.9+.
TypeScript
Entièrement typé. Zéro dépendance. Fonctionne dans Node.js, Deno et Bun.
CLI
Gérez les jeux de données, exports et le stockage depuis votre terminal.
curl -fsSL https://avala.ai/install.sh | bash.REST API
Utilisez l’API directement depuis n’importe quel langage avec des requêtes HTTP.
OpenAPI
Générez votre propre client à partir de la spécification OpenAPI.
Comparaison rapide
| Fonctionnalité | Python | TypeScript | CLI | REST API |
|---|---|---|---|---|
| Installation | pip install avala | npm install @avala-ai/sdk | curl -fsSL https://avala.ai/install.sh | bash | HTTP direct |
| Asynchrone | Sync + Async | Async | N/A | Tous |
| Sécurité de type | Annotations de type complètes | Types TypeScript complets | N/A | N/A |
| Réessais automatiques | Oui | Oui | Via SDK | Manuel |
| Pagination | Itérateurs intégrés | Itérateurs intégrés | Flag --limit | Manuel |
| Dépendances | httpx, pydantic | Aucune (fetch natif) | click, rich | N/A |
Variables d’environnement
Tous les SDKs respectent les variables d’environnement suivantes, vous pouvez donc les configurer une fois et les utiliser dans toute votre stack.| Variable | Description | Défaut |
|---|---|---|
AVALA_API_KEY | Votre clé API Avala pour l’authentification. Utilisée automatiquement si aucune clé n’est passée au constructeur du client. | Aucun (requis) |
AVALA_BASE_URL | Remplace l’URL de base de l’API par défaut. Utile pour les déploiements auto-hébergés ou les environnements de développement. | https://api.avala.ai/api/v1 |
Authentification
Toutes les requêtes à l’API Avala doivent inclure votre clé API dans l’en-têteX-Avala-Api-Key. Vous pouvez trouver votre clé API dans le tableau de bord Avala sous Paramètres > Sécurité.
Intégration MCP
Utilisez Avala avec des assistants IA comme Claude, Cursor et VS Code via le Model Context Protocol. Le package@avala-ai/mcp-server expose vos jeux de données, projets et exports comme des outils que les assistants IA peuvent appeler directement.