Accès API (offre Pro)
Avec l'offre Pro, vous pouvez utiliser Imara AI depuis vos propres outils : un script Python, un tableur, un bot Discord, un tableau de bord interne…
1. Créer une clé
- Ouvrez Paramètres › API.
- Donnez un nom à la clé (ex. « Tableur Google ») et cliquez sur Créer une clé.
- Copiez-la immédiatement : elle commence par
imara_sk_et ne sera plus jamais affichée.
Vous pouvez avoir jusqu'à dix clés actives. Créez-en une par outil : si l'une fuit, vous la révoquez sans casser les autres.
2. L'utiliser
Envoyez la clé dans l'en-tête X-API-Key :
curl https://api.imaraia.com/api/v1/analysis \
-H "X-API-Key: imara_sk_…" \
-H "Content-Type: application/json" \
-d '{"symbol": "BTC/USD", "timeframe": "4h"}'
En Python :
import os, requests
r = requests.post(
"https://api.imaraia.com/api/v1/analysis",
headers={"X-API-Key": os.environ["IMARA_API_KEY"]},
json={"symbol": "EUR/USD", "timeframe": "1h"},
)
print(r.json()["narrative"]["summary"])
Tous les points d'accès sont décrits dans le guide Intégrer l'API.
3. Ce qu'une clé peut faire
| Autorisé | Refusé |
|---|---|
| Analyses, chat, scanner | Modifier le profil ou le mot de passe |
| Journal, alertes, listes de suivi | Créer ou révoquer des clés |
| Données de marché, actualités | Gérer l'abonnement |
| Gestion du risque, backtests | Supprimer ou exporter le compte |
Les quotas quotidiens de votre offre s'appliquent, avec une limite de 60 requêtes par minute et par clé.
4. Sécurité
- Ne publiez jamais une clé (dépôt Git, capture d'écran, forum). Le préfixe
imara_sk_permet aux outils de détection de secrets de la repérer. - Rangez-la dans une variable d'environnement, pas dans le code.
- Une clé compromise se révoque depuis Paramètres › API : elle cesse de fonctionner immédiatement.
- Si vous quittez l'offre Pro, vos clés sont conservées mais inactives jusqu'à votre retour.