Welcome
Upload, manage, search, transform and generate images and videos with the Cloudinary API.
The Cloudinary API lets you upload, store, manage, search, transform and generate images and videos. Upload from a file, URL or stream; organize assets with folders, tags, contextual and structured metadata; search the whole library with expressions; and deliver optimized, transformed media from a global CDN.
What you'll find here
- API Reference: all 127 operations of the Cloudinary API v1.1, grouped by capability (Upload, Assets, Asset Metadata, Search, Folders, Transformations, Upload Presets, Metadata Fields and Rules, Triggers, Streaming Profiles, Generation, Collections and more), with request and response examples and a live API playground.
- SDKs: client libraries for C#, Python and TypeScript, generated by APIMatic, with code samples on every endpoint.
- Context Plugin: brings the API and SDKs into AI coding assistants such as Claude Code, Cursor and Codex.
Base URLs
| Region | Base URL |
|---|---|
| Global (default) | https://api.cloudinary.com |
| Europe | https://api-eu.cloudinary.com |
| Asia Pacific | https://api-ap.cloudinary.com |
Every path includes your product environment's cloud name, for example /v1_1/{cloud_name}/resources/image.
Authentication
Use HTTP Basic authentication with your API key and API secret:
Authorization: Basic base64(API_KEY:API_SECRET)Find your cloud name, API key and secret in the Cloudinary Console. OAuth 2.0 (authorization code) is also supported, with the asset_management, upload and media_generation scopes.
Common tasks
- Upload an image or video:
POST /v1_1/{cloud_name}/{resource_type}/upload - Search your assets:
POST /v1_1/{cloud_name}/resources/search - Get an asset's details:
GET /v1_1/{cloud_name}/resources/{resource_type}/{type}/{public_id} - Tag many assets at once:
POST /v1_1/{cloud_name}/{resource_type}/tags - Generate an image from a prompt:
POST /v2/generate/{cloud_name}/text_to_image