Autres ressources
Liens utiles, bibliothèques compatibles, conditions d'usage et contacts.
Les surfaces CloudZIR#
| Adresse | À quoi ça sert |
|---|---|
| api.cloudzir.com | Cette documentation, et l'API elle-même (/v1, /anthropic). |
| plateforme.cloudzir.com | Clés, solde, recharges, consommation, support. |
| ai.cloudzir.com | Le chat CloudZIR AI, gratuit, pour tester les modèles sans code. |
| cloudzir.com | CloudZIR : hébergement, domaines et services. |
Bibliothèques compatibles#
Les bibliothèques qui parlent le protocole OpenAI ou Anthropic fonctionnent dans les limites documentées (certains champs sont acceptés puis ignorés ou refusés : voir les pages de référence). Les plus courantes :
| Écosystème | Bibliothèque | Réglage |
|---|---|---|
| Python | openai | base_url="https://api.cloudzir.com/v1" |
| Python | anthropic | base_url="https://api.cloudzir.com/anthropic" |
| Python | langchain-openai | ChatOpenAI(base_url=…, model="mina-low") |
| Python | llama-index | OpenAILike(api_base=…, is_chat_model=True) |
| JS / TS | openai | baseURL: "https://api.cloudzir.com/v1" |
| JS / TS | @anthropic-ai/sdk | baseURL: "https://api.cloudzir.com/anthropic" |
| JS / TS | @ai-sdk/openai-compatible | baseURL: "https://api.cloudzir.com/v1" |
| Go | go-openai | config.BaseURL = "https://api.cloudzir.com/v1" |
| PHP | openai-php/client | ->withBaseUri("api.cloudzir.com/v1") |
| Tout langage | HTTP brut | Voir la référence |
Agents et éditeurs#
Bonnes pratiques de sécurité#
- Jamais de clé côté navigateur ni dans un dépôt Git. Utilisez des variables d'environnement ou un gestionnaire de secrets.
- Une clé par environnement (développement, préproduction, production) : la révocation devient chirurgicale et la consommation reste lisible.
- Détection de secrets : ajoutez le motif
zir_ai_[0-9a-f]{48}à vos règles (gitleaks, trufflehog, GitHub secret scanning). - Rotation régulière : créez la nouvelle clé, déployez, puis révoquez l'ancienne, sans interruption.
- Surveillez le solde par GET /v1/user/balance : une consommation inhabituelle est le premier signe d'une fuite.
Conditions d'utilisation#
En utilisant l'API CloudZIR, vous vous engagez à :
- respecter la loi algérienne et celle de vos utilisateurs finaux ;
- ne pas générer de contenu illicite, ni usurper l'identité d'une personne ou d'une institution ;
- ne pas revendre l'accès en marque blanche sans accord écrit ;
- informer vos utilisateurs finaux qu'ils interagissent avec un système d'IA ;
- ne pas tenter de contourner les limites de débit ni de partager une clé entre organisations.
La disponibilité de l'API est engagée à 99,9 % par mois par les conditions générales (article 10.6), hors maintenance annoncée et hors force majeure ; un manquement constaté ouvre droit à une compensation en jetons. CloudZIR peut suspendre un accès en cas d'usage abusif. Le solde non consommé n'est pas remboursable (conditions générales, article 10.3).
Confidentialité#
- Le contenu de vos requêtes n'est pas utilisé pour entraîner des modèles.
- Pour les appels synchrones de conversation, le contenu des messages et des images n'est pas enregistré par les routes de l'API; les métadonnées d'usage le sont. Les fichiers téléversés via l'API Fichiers sont supprimés par une requête dédiée et ne font pas l'objet d'une expiration automatique.
- Où vos données sont traitées et comment leur suppression fonctionne : voir Stockages et confidentialité.
- Ne transmettez pas de données personnelles inutiles dans vos prompts, et n'utilisez
jamais d'email ou de téléphone comme identifiant
user: préférez un identifiant opaque.
Support#
| Besoin | Où |
|---|---|
| Question technique, bug, demande de fonctionnalité | Help & Feedback |
| Recharge non créditée, facturation | Même formulaire, en joignant la référence du versement |
| Augmentation de limites, volumes importants | Même formulaire, en précisant votre volume cible |
| support@cloudzir.com |
Pour toute erreur, joignez le X-Request-Id et l'horodatage UTC : c'est ce
qui permet de retrouver la trace exacte.