Authentification
Authentifiez chaque protocole d'API pris en charge en toute sécurité avec une clé API AnyInt.
Chaque requête d'API développeur nécessite une clé API AnyInt active. Utilisez l'en-tête attendu par votre protocole client afin que les SDK OpenAI, Anthropic et Gemini existants continuent de fonctionner.
Authentification recommandée par protocole
| Protocole | Entrée recommandée | Base canonique de l'API |
|---|---|---|
| Compatible avec OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Messages Anthropic | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| API Développeur Gemini | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| Média asynchrone | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/v1/async-tasks |
Pour la compatibilité client, la passerelle accepte également les en-têtes de clé AnyInt pris en charge sur toutes les familles de protocoles et accepte le paramètre de requête key de Gemini sur les routes Gemini. Préférez les en-têtes afin que les informations d'identification n'apparaissent pas dans les URL ou les journaux intermédiaires.
La passerelle consomme l'identifiant AnyInt avant le routage du fournisseur. Elle ne transmet jamais cet identifiant comme clé de fournisseur en amont. Les clés invalides, expirées ou révoquées échouent en mode fermé.
Créer une clé
Créez une clé API dans la console, puis stockez-la dans un gestionnaire de secrets côté serveur ou une variable d'environnement.
Les clés AnyInt nouvellement émises utilisent le préfixe sk- suivi de 52 caractères Base64URL (55 caractères au total). Les clés ak_ existantes restent valides jusqu'à ce que vous les remplaciez ou les désactiviez. Copiez toujours la valeur complète affichée par la console ; n'ajoutez ni ne supprimez vous-même un préfixe.
export ANYINT_API_KEY="your_api_key"Directives de sécurité
- Stockez les clés dans un gestionnaire de secrets côté serveur ou une variable d'environnement.
- Ne placez jamais une clé dans du JavaScript côté client, un contrôle de code source, des journaux ou des URL.
- Utilisez une clé distincte pour chaque application et environnement.
- Remplacez une clé immédiatement si elle a pu être exposée.
- Ne transmettez pas les clés AnyInt aux fournisseurs en amont.
Tester l'authentification
Listez les modèles pour vérifier la clé avant d'envoyer une requête d'inférence.
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"Une erreur d'authentification renvoie un HTTP 401 avec une erreur formatée selon le protocole. Une clé valide peut toujours recevoir un 402 pour un solde insuffisant ou un 503 lorsqu'aucun fournisseur éligible n'est disponible.
Dépannage des erreurs courantes
Lorsqu'une requête d'API échoue, utilisez ce tableau pour identifier rapidement la cause et la solution :
| Statut HTTP | Cause courante | Dépannage et solution |
|---|---|---|
| 401 Unauthorized | Clé API invalide ou expirée, ou en-tête manquant | Vérifiez votre jeton Bearer ou votre en-tête x-api-key ; assurez-vous que la clé est active dans Clés API de la console. |
| 402 Payment Required | Solde insuffisant ou limite de budget mensuel atteinte | Ajoutez des crédits dans la console ou augmentez la limite de budget mensuel de la clé API. |
| 403 Forbidden | Restriction d'IP, incompatibilité d'environnement ou autorisations insuffisantes | Vérifiez la portée de votre clé API et contrôlez votre IP cliente dans la liste des IP autorisées. |
| 404 Not Found | Chemin de point de terminaison incorrect ou ID de modèle inconnu | Vérifiez le chemin de la Base URL ; appelez GET /v1/models pour confirmer que le modèle est actif. |
| 429 Too Many Requests | Limite de débit (RPM/TPM) ou plafond de requêtes simultanées atteint | Réduisez la concurrence, configurez un délai exponentiel (backoff), ou demandez une augmentation de quota dans la console. |
| 502 Bad Gateway | Erreur réseau du fournisseur en amont ou réponse corrompue | La passerelle AnyInt tente automatiquement un basculement multi-canaux ; si le problème persiste, signalez-le via les journaux de requêtes de la console. |
| 503 Service Unavailable | Tous les canaux candidats sont temporairement indisponibles | Réessayez après un court délai ou basculez vers un modèle équivalent de secours. |
| 504 Gateway Timeout | Délai d'inférence en amont dépassé (modèles de raisonnement complexes) | Vérifiez la complexité de l'invite ; augmentez le délai d'attente client ; activez le streaming (stream: true) pour les modèles de raisonnement. |