Cloudinary API
Stockage, transformation et diffusion d'images et de vidéos par API et CDN.
Cloudinary est une plateforme de gestion de médias dans le cloud qui prend en charge tout le cycle de vie des images et des vidéos : envoi (upload), stockage, transformation à la volée, optimisation et diffusion via un CDN mondial. Tout est pilotable par API REST et par des SDK pour la plupart des langages et frameworks. Elle s'adresse aux développeurs et aux entreprises qui veulent automatiser le redimensionnement, le recadrage intelligent, la compression et la livraison performante de médias à grande échelle.
Que propose l'API Cloudinary ?
Tarifs de l'API Cloudinary
Modèle par crédits mensuels, valables indistinctement pour trois usages : 1 crédit = 1 000 transformations, ou 1 Go de stockage, ou 1 Go de bande passante. On répartit librement ses crédits entre ces trois postes. Plan gratuit, puis abonnements mensuels avec davantage de crédits et de fonctionnalités, et une offre Enterprise sur devis.
Offre gratuite — Plan gratuit avec 25 crédits par mois (soit, par exemple, 25 000 transformations, 25 Go de stockage ou 25 Go de bande passante, à répartir librement), jusqu'à 3 utilisateurs et sans carte bancaire requise.
Authentification & intégration
Authentification par API Key et API Secret du compte (cloud_name + key + secret). Les appels d'API signés utilisent une signature calculée à partir de l'API Secret ; les transformations en lecture seule peuvent passer par des URLs publiques non signées.
API REST et SDK officiels (Node.js, Python, PHP, Java, Ruby, .NET, Go, et SDK front-end React, Vue, Angular, iOS, Android). Deux grands flux : l'upload (signé ou non signé, depuis serveur, navigateur ou URL distante) et la transformation/diffusion par paramètres d'URL servis via le CDN. Webhooks de notification disponibles après upload ou traitement asynchrone.
Cas d'usage de l'API Cloudinary
- Servir des images optimisées et redimensionnées à la volée selon l'appareil et le navigateur.
- Automatiser le recadrage intelligent sur le sujet pour des vignettes et bannières.
- Transcoder et diffuser des vidéos en streaming adaptatif via le CDN.
- Centraliser et organiser les médias d'une entreprise dans une bibliothèque (DAM) avec auto-tagging.
- Détourer le fond, appliquer des watermarks ou modérer du contenu via les add-ons IA.
- Accélérer un site e-commerce en déléguant tout le pipeline image/vidéo à Cloudinary.
✓ Points forts
- Plateforme complète : upload, stockage, transformation, optimisation et CDN en un seul service.
- Transformations puissantes par simple paramètre d'URL, sans traitement côté serveur.
- Optimisation automatique du format et de la qualité selon le contexte de diffusion.
- SDK officiels pour la plupart des langages et frameworks, front comme back.
- Plan gratuit généreux (25 crédits/mois) pour démarrer sans engagement.
⚠ Limites
- Le modèle par crédits regroupant transformations, stockage et bande passante peut rendre la prévision de coût difficile.
- Le passage du plan gratuit aux plans payants est marqué : 99 $/mois pour le premier palier.
- Certaines fonctionnalités avancées (add-ons IA) consomment des crédits supplémentaires ou nécessitent un plan supérieur.
- Périmètre large : la prise en main complète demande un temps d'apprentissage.
Questions fréquentes sur l'API Cloudinary
Cloudinary est-il gratuit ?
Oui, il existe un plan gratuit avec 25 crédits par mois et jusqu'à 3 utilisateurs, sans carte bancaire. Au-delà, des plans payants débutent à 99 $/mois (plan Plus) pour davantage de crédits et de fonctionnalités.
Qu'est-ce qu'un crédit Cloudinary ?
Un crédit équivaut à 1 000 transformations, ou 1 Go de stockage, ou 1 Go de bande passante. Vous répartissez librement vos crédits mensuels entre ces trois postes selon vos besoins.
Comment authentifier mes appels d'API ?
Avec le cloud_name, l'API Key et l'API Secret de votre compte. Les appels d'upload ou de gestion sont signés à l'aide de l'API Secret, tandis que les transformations de diffusion peuvent utiliser des URLs publiques non signées.
Comment fonctionnent les transformations d'images ?
Elles s'appliquent à la volée via des paramètres ajoutés à l'URL de l'image (largeur, recadrage, qualité, format, filtres). Le résultat est généré puis mis en cache et servi par le CDN, sans traitement côté serveur.
Cloudinary gère-t-il aussi la vidéo ?
Oui. La plateforme assure le transcodage, le streaming adaptatif, la génération de vignettes et les transformations vidéo à la demande, en plus de la gestion des images.
Pour quels langages existe-t-il des SDK ?
Cloudinary fournit des SDK officiels pour Node.js, Python, PHP, Java, Ruby, .NET, Go, ainsi que des SDK front-end pour React, Vue, Angular, iOS et Android.
