Questions fréquentes

Les questions les plus fréquentes sur l'API CloudZIR. Si la vôtre n'y est pas, écrivez-nous depuis Help & Feedback.

Démarrage#

Faut-il un abonnement ?#

Non. L'API est prépayée : vous rechargez un portefeuille en dinars et chaque requête le débite. Pas d'engagement, pas de frais fixes, pas de date d'expiration du solde.

Puis-je utiliser mon compte du chat ?#

Oui : c'est le même compte. Connectez-vous sur plateforme.cloudzir.com avec vos identifiants ai.cloudzir.com. Le portefeuille API est en revanche distinct de l'usage du chat.

Y a-t-il des crédits gratuits ?#

Pas aujourd'hui : le compte démarre à zéro et il faut une première recharge pour appeler l'API. Si une offre de bienvenue est ouverte plus tard, elle sera créditée automatiquement et visible dans Billing comme n'importe quel autre mouvement.

Facturation#

Comment est calculé le prix d'une requête ?#

jetons d'entrée × prix d'entrée + jetons de sortie × prix de sortie, sur la base des tarifs par million de jetons de la page Modèles et prix. Le décompte de jetons utilisé est celui renvoyé par le modèle dans usage. Les jetons d'entrée servis depuis le cache sont facturés bien moins cher (détail).

Une requête en erreur est-elle facturée ?#

Non pour les erreurs 4xx et 5xx qui n'ont produit aucun texte (400, 401, 402, 404, 429, 503). Une génération interrompue en cours de streaming est facturée pour ce qui a été produit.

Mon solde peut-il devenir négatif ?#

Marginalement : le débit a lieu après la réponse, donc plusieurs requêtes lancées simultanément avec un solde presque nul peuvent le faire passer légèrement en dessous de zéro. Les appels suivants sont alors refusés en 402 jusqu'à la recharge.

Puis-je payer en dinars ?#

Oui. Les tarifs, le portefeuille et les recharges sont en dinars algériens (DA). Les moyens de paiement proposés apparaissent sur la page Top up de la plateforme.

Ai-je une facture ?#

L'historique complet des recharges et des mouvements est dans Billing, exportable en CSV. Pour un document nominatif à en-tête (entreprise, NIF), demandez-le depuis Help & Feedback.

Technique#

Mon code écrit pour OpenAI fonctionnera-t-il ?#

Oui, pour les points d'accès et les paramètres documentés ici : changez base_url en https://api.cloudzir.com/v1, la clé, et le nom du modèle. Certains champs sont acceptés puis ignorés ou refusés : la page de référence de chaque surface le précise. Idem pour du code écrit pour Anthropic avec https://api.cloudzir.com/anthropic.

Quels modèles se cachent derrière Mina ?#

Mina est un service, pas un modèle unique : chaque requête est routée vers un moteur disponible, avec une chaîne de secours automatique en cas de panne. Cette composition évolue pour améliorer qualité, latence et disponibilité, sans changement d'API ni de tarif de votre côté. Les réponses renvoient toujours le nom Mina demandé.

Puis-je appeler l'API depuis un navigateur ?#

Techniquement oui, mais ne le faites pas : cela exposerait votre clé à tous vos visiteurs. Passez par votre serveur, qui détient la clé et relaie les requêtes.

Les réponses sont-elles déterministes ?#

Non. Même avec temperature: 0, deux appels identiques peuvent différer légèrement. Le paramètre seed est accepté puis ignoré : il n'a aucun effet.

Quelle est la durée maximale d'une requête ?#

Prévoyez un timeout client d'au moins 120 secondes. Pendant l'attente, la connexion est maintenue ouverte (commentaires SSE : keep-alive en streaming).

Combien de requêtes puis-je envoyer par minute ?#

Selon votre palier : 30, 300 ou 1 200 requêtes par minute, avec 2, 10 ou 30 requêtes simultanées. Voir Limitation du débit.

Données et sécurité#

Mes prompts servent-ils à entraîner des modèles ?#

Non. CloudZIR n'utilise pas le contenu de vos requêtes pour entraîner ou affiner des modèles. Pour les appels synchrones de conversation, les messages et images ne sont pas enregistrés par les routes de l'API; les métadonnées d'usage nécessaires à la facturation et au support le sont. Les fichiers envoyés avec l'API Fichiers sont stockés séparément et supprimés par DELETE /v1/files/{file_id}. Aucune expiration automatique ne leur est appliquée.

Où sont traitées mes données ?#

La passerelle de l'API s'exécute aux États-Unis ; la base de données, l'authentification et le stockage des fichiers sont hébergés dans l'Union européenne. Selon le moteur sollicité, l'inférence est exécutée par des prestataires situés principalement aux États-Unis et, pour certains moteurs, dans d'autres pays (notamment en Asie). La création du compte vaut consentement exprès à ce transfert hors d'Algérie (articles 44 et 45 de la loi n° 18-07). Le détail est dans Stockages et confidentialité et dans la politique de confidentialité. Pour une question sur la localisation des traitements, écrivez à support@cloudzir.com (objet « Protection des données »).

J'ai perdu ma clé, puis-je la récupérer ?#

Non : seule une empreinte est stockée. Révoquez-la et créez-en une nouvelle depuis API keys. La révocation prend effet en moins d'une minute.

Ma clé a fuité, que faire ?#

Révoquez-la immédiatement dans la plateforme, créez-en une autre, puis vérifiez Usage pour repérer une consommation anormale. Signalez-nous tout usage frauduleux : nous pouvons enquêter avec les identifiants de requête.

Puis-je limiter une clé à un usage précis ?#

Oui, depuis la plateforme : sur la page API keys, ouvrez la ligne « Régler les limites » qui porte le nom de la clé concernée. Chaque clé peut porter :

• les modèles et les points d'entrée qu'elle peut appeler (par exemple /v1/chat/completions) ;
• son propre débit (requêtes par minute) et sa propre concurrence (requêtes simultanées) : ils ne peuvent qu'abaisser ceux de votre palier, jamais les relever ;
• un budget mensuel (le mois calendaire, en UTC) et un coût maximum par requête, en dinars.

Restriction par adresse IP : pas disponible pour le moment. Derrière notre infrastructure, l'adresse source de vos appels ne peut pas être vérifiée de façon fiable : une restriction qui s'appuierait dessus donnerait une fausse impression de sécurité. La plateforme ne propose donc plus ce champ. L'API refuse d'enregistrer une liste d'adresses (400, paramètre cidr_allowlist) et refuse les appels d'une clé qui en porte déjà une (403 account_disabled) : enregistrez de nouveau les limites de la clé, la liste est alors retirée.

Un champ vide ne pose aucune restriction. Décocher « Autoriser les appels avec cette clé » suspend la clé : elle refuse alors toute requête, lecture des fichiers, des lots, de la liste des modèles et du solde comprise. Ces contrôles ont lieu avant l'appel au modèle. Une requête hors des modèles ou des points d'entrée autorisés reçoit 403 account_disabled. Le coût maximum et le budget portent sur le coût maximal possible de la requête (jetons d'entrée estimés plus max_tokens), pas sur son coût final : une requête qui les dépasserait reçoit 402 insufficient_balance, même si votre solde est suffisant, et baisser max_tokens peut la faire passer.

Ce qui n'existe pas : une date d'expiration de clé, et un budget cumulé sur la vie de la clé (le budget repart à zéro chaque mois). La suspension et la liste des points d'entrée autorisés s'appliquent à toutes les routes qui acceptent une clé, fichiers, lots, liste des modèles et solde compris : une clé limitée à certains points d'entrée n'atteint ces routes que si leur chemin figure dans la liste (/v1/files, /v1/files/{file_id}, /v1/files/{file_id}/content, /v1/batches, /v1/batches/{batch_id}, /v1/batches/{batch_id}/cancel, /v1/models, /anthropic/v1/models et /v1/user/balance). Les restrictions de modèles et de coût (budget compris) ne portent que sur les appels de génération, les routes de calcul (embeddings, modération, OCR, rerank, comptage de jetons) et la création de lots. Pour séparer vos environnements, créez aussi plusieurs clés : leur consommation est suivie séparément dans Usage.

Fonctionnalités#

Puis-je envoyer des images ?#

Oui, sur les trois modèles et sur les deux surfaces : PNG, JPEG, WebP et GIF, jusqu'à 8 Mo par image et 8 images par requête. Voir Vision.

Puis-je envoyer des documents ?#

Oui : téléversez-les avec l'API Fichiers, CloudZIR en extrait le texte, et vous l'injectez dans vos prompts. Les PDF scannés (sans couche texte) doivent passer par Vision.

Puis-je contrôler le raisonnement du modèle ?#

Oui : thinking pour l'activer ou le couper, reasoning_effort pour en régler l'intensité. Couper le raisonnement sur une tâche simple peut réduire nettement le temps de réponse (près de moitié dans l'exemple du guide, selon la question). Voir Mode de pensée.

L'API génère-t-elle des images ou de l'audio ?#

Non. L'API publique couvre la génération de texte. Génération d'images et voix sont disponibles dans le produit CloudZIR AI, pas encore comme endpoints facturés.

Y a-t-il un SLA ?#

Oui. Les conditions générales (article 10.6) engagent CloudZIR sur une disponibilité de 99,9 % de l'API, mesurée mensuellement, hors maintenance annoncée à l'avance et hors force majeure. En cas de manquement constaté sur un mois, vous pouvez demander une compensation en jetons à support@cloudzir.com. Des chaînes de secours prennent le relais automatiquement en cas de défaillance d'un moteur. Les incidents sont publiés sur Nouvelles.