Parcours des données
- Votre application envoie sa clé API et sa requête à l’adresse HTTPS
https://rockapi.ai/v1. Effectuez cet appel côté serveur ; consultez Authentification. - La passerelle vérifie la clé et le compte, applique les restrictions configurées et sélectionne un canal en amont. Selon l’interface et le canal, elle peut remapper le nom du modèle, convertir le format, remplacer des paramètres ou transmettre directement le corps de la requête.
- Le service en amont reçoit les éléments nécessaires à l’inférence : messages, entrées des outils, médias fournis ou références à ces médias. La passerelle traite la réponse et les informations d’utilisation, puis renvoie le résultat au client.
- Les journaux d’utilisation et d’erreur servent à la facturation et au diagnostic. Les tâches multimédias asynchrones peuvent aussi conserver des entrées, un état, des données du prestataire et des URL de résultat. Leurs enregistrements diffèrent des journaux des requêtes textuelles.
Protéger et révoquer les clés API
Créez des clés API distinctes par application et environnement. Lorsque l’éditeur le permet, définissez une expiration, un quota limité, les modèles autorisés et une liste d’adresses IP autorisées. Avant le transfert vers un modèle, l’implémentation contrôle l’état de la clé, son expiration, son quota disponible et les restrictions IP configurées ; les restrictions de modèles limitent le routage. Testez la liste depuis l’adresse IP de sortie réelle de votre application. Conservez les clés dans un gestionnaire de secrets côté serveur ou une configuration d’exécution protégée. Excluez-les des fichiers JavaScript distribués au navigateur, applications mobiles, dépôts, URL, captures d’écran et traces partagées. Préférez l’en-tête d’authentification documenté aux paramètres d’URL. Les réponses de liste et de détail masquent la clé, tandis qu’une opération authentifiée distincte permet d’obtenir sa valeur complète. Ce masquage concerne l’affichage ; il ne prouve ni un hachage irréversible ni un chiffrement au repos. Pour une rotation courante, créez une clé de remplacement, mettez l’application à jour, vérifiez un appel, puis désactivez ou supprimez l’ancienne clé. En cas de fuite, révoquez d’abord la clé exposée, remplacez-la et cherchez les appels inhabituels dans les journaux d’utilisation. Vérifiez que l’ancienne clé est refusée et contactez l’assistance si elle fonctionne encore. La révocation n’efface pas les enregistrements historiques.Contenu possible des journaux
La journalisation de la consommation et l’agrégation des usages sont configurables. Les vues destinées aux utilisateurs retirent certains détails administratifs ; elles ne recensent donc pas tous les champs stockés. Désactiver une catégorie ou la préférence IP ne désactive pas tous les journaux d’accès, de sécurité, de tâches ou d’infrastructure. Consultez Tarification et facturation pour rapprocher les consommations.
Réduire les données transmises
Envoyez uniquement les échanges, extraits de documents, résultats d’outils et médias nécessaires. Retirez mots de passe, jetons d’accès, données de paiement et informations personnelles sans rapport avec la tâche. Remplacez l’identité des clients par des pseudonymes internes et gardez la correspondance dans votre système. Vérifiez aussi les noms de fichiers, métadonnées multimédias, en-têtes personnalisés et URL signées. Validez toute nouvelle intégration avec des données fictives. Pour demander de l’aide, commencez par l’identifiant de requête ou de tâche, la date avec fuseau horaire, l’identifiant du modèle, le chemin de l’interface, le statut HTTP et le libellé de la clé. Ajoutez au besoin une courte erreur expurgée ou un exemple minimal. N’envoyez ni clé complète, ni en-tête d’authentification, ni conversation privée, ni URL multimédia signée non expurgée.Conservation, entraînement et conformité
L’implémentation établit les fonctions de traitement et de journalisation. Elle ne prouve aucune politique générale de conservation nulle, aucun engagement de non-utilisation pour l’entraînement ni aucun délai fixe de suppression pour Rock API et tous ses prestataires. Avant d’utiliser des données sensibles, contactez l’assistance via la page À propos du site principal pour confirmer :- Conservation et accès : quels corps de requête, sorties, fichiers de tâches, journaux d’utilisation, journaux d’accès et sauvegardes sont conservés ? Pendant combien de temps, avec quels droits d’accès et quelles exceptions ?
- Entraînement et autres usages : Rock API ou le prestataire effectivement utilisé exploitent-ils les entrées et sorties pour l’entraînement, l’évaluation, l’examen d’abus ou d’autres usages ? Quelles exclusions ou possibilités de refus couvrent votre compte et votre routage ?
- Prestataires et localisation : quels intervenants et régions traitent le modèle choisi, y compris lors de nouvelles tentatives ou de routages de secours ? Peut-on imposer des restrictions géographiques à votre traitement ?
- Justificatifs contractuels : un accord de traitement des données (DPA) est-il disponible ? Quelles garanties de transfert, certifications de sécurité et attestations d’audit couvrent le service souscrit et son périmètre ?
