> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Passerelle API IA : accès aux modèles, facturation et premier appel

> Comprenez le rôle d'une passerelle IA et vérifiez l'accès aux modèles avec une clé de plateforme, une URL complète et les journaux de consommation.

Une **passerelle API IA** se place entre votre application et les fournisseurs de modèles. Elle authentifie la requête, l'achemine vers un modèle pris en charge et renvoie une réponse selon l'interface documentée. Elle peut réduire les configurations répétées et regrouper le suivi des usages. Elle ne rend pas tous les modèles équivalents.

Un service OpenAPI peut avoir son propre abonnement, sa propre authentification et ses propres endpoints. Il ne faut pas le traiter automatiquement comme un modèle de conversation.

## Comparer avec un accès direct

L'accès direct convient parfois à une application qui dépend des fonctions natives d'un seul fournisseur. Une passerelle peut faciliter l'évaluation de plusieurs familles et centraliser la gestion des clés. Vérifiez toutefois le périmètre réel du service avant de déplacer le trafic.

| Critère | Accès direct | Vérification côté passerelle |
| - | - | - |
| Client | API de chaque fournisseur | Endpoints et comportement du SDK pris en charge |
| Fonctions | Documentation actuelle du fournisseur | Fonctions réellement exposées pour le modèle choisi |
| Coût | Comptes distincts à rapprocher | Tarif, groupe applicable et consommation liquidée |
| Exploitation | Erreurs du fournisseur | Erreurs, délais et limitations de la passerelle aussi |

L'URL de base complète des modèles compatibles OpenAI de Rock API est `https://rockapi.ai/v1`. Une URL unique ne garantit ni basculement automatique, ni réponses identiques, ni accès à toutes les fonctions natives.

## Envoyer une première requête

1. Consultez le [catalogue actuel et les prix](https://rockapi.ai/pricing). Choisissez un modèle de conversation, copiez son identifiant exact et vérifiez l'accès de votre compte et du groupe sélectionné.
2. [Créez un compte](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=docs_launch), vérifiez le solde nécessaire et créez une clé dans [Clés API](https://rockapi.ai/keys). Conservez-la côté serveur dans `ROCK_API_KEY`.
3. Affectez l'identifiant copié à `ROCK_API_MODEL`. Le SDK utilise l'URL de base `https://rockapi.ai/v1` ; curl appelle l'endpoint complet ci-dessous.
4. Commencez par un texte court avant les outils, les images ou le streaming.

```bash theme={null}
curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ROCK_API_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Réponds bonjour.\"}]}"
```

Définissez les deux variables localement avant l'exécution. L'identifiant dépend du catalogue et des droits du compte ; cet exemple ne promet aucun modèle particulier. L'acheteur crée une clé de plateforme, sans configurer de canaux fournisseurs en amont.

## Vérifier réponse et consommation

Contrôlez le statut HTTP, le corps, le modèle et l'usage retourné. Retrouvez l'entrée correspondante dans le tableau de bord pour comparer groupe, catégories de consommation et montant final. Le [guide de facturation](https://docs.rockapi.ai/fr/pricing-and-billing.md) distingue tarification à l'usage, à l'appel et dynamique. Une réservation temporaire peut différer du montant liquidé ; aucune remise universelle ne s'applique à tous les modèles.

Pour `401` ou `403`, vérifiez clé et autorisations ; pour `400` ou `404`, modèle, corps et chemin ; pour `429`, quota et limites avant toute nouvelle tentative. Conservez l'heure et l'identifiant de requête disponible, sans secrets. Consultez les [erreurs et limites](https://docs.rockapi.ai/fr/errors-and-rate-limits.md).

Après ce premier succès, utilisez le [guide de validation de migration](https://docs.rockapi.ai/fr/blog/buyers/openai-compatible-api.md). Avant d'envoyer des données privées à un intermédiaire supplémentaire, examinez la [sécurité et la confidentialité](https://docs.rockapi.ai/fr/security-and-privacy.md) ainsi que les conditions applicables.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.