Documentation Index

Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt

Use this file to discover all available pages before exploring further.

Image & Video APIs

AI Power Start

Last updated: Jul-28-2026

Copy the Get Started prompt from this page to configure Cloudinary in your active project. The prompts work with Cursor, Claude, Antigravity, GitHub Copilot, and other AI coding assistants.

As you explore this page, you'll learn what the setup prompt installs, what each tool provides, and which recommended tools can further enhance your workflow.

After you run the setup prompt in your IDE, your AI coding assistant will suggest next steps, including prompts for adding Cloudinary image and video features to your project. You can follow those suggestions or return to this page for additional prompts.

The Get Started prompt

Open your new or existing project in any AI-powered IDE, then copy and paste the prompt:

cloudinary-get-started-prompt.md View Full Prompt
# Use these instructions to get started with Cloudinary in this directory
Set up or validate Cloudinary in a new or existing project, including the detected-stack SDK, credentials, AI tooling, delivery validation, and next steps.
## Operating principle
Run Cloudinary onboarding as a guarded, SDK-agnostic stage flow. Detect the project stack first, then use the official Cloudinary SDK, framework docs, or Cloudinary docs that match that stack.
...

What happens after you paste it

The following five stages run in order. Your agent pauses for confirmation at each gate. Nothing runs without your approval. Anything already set up in your project or globally in your IDE is skipped.

1

AI tooling

Installs Cloudinary MCP servers and agentic skills in your IDE.

2

Framework detection

Confirms your detected stack and how you deliver media.

3

SDK & environment

Installs the right SDK and helps you set up your .env.

4

Credentials

Walks you through adding your keys safely.

5

Verification

Validates your setup with an upload preset, transformation, and optimization check.

Get the most from your AI coding assistant

The Get Started prompt configures your AI coding assistant to work with Cloudinary by setting up MCP servers and agentic skills. Here's what gets set up for you, along with additional tools and tips to help you get the most out of it.

For the full guide, see Cloudinary AI agent tools and MCP servers.

Keep prompting

The Get Started prompt ends with a few example prompts to help you build common Cloudinary features. If you're looking for more, copy one of these prompts and paste it into your AI coding assistant.

Important
These prompts work best after you've run the Get Started prompt, which configures your Cloudinary environment for the project.

If you don't run the Get Started prompt, make sure your project is configured with a Cloudinary SDK and your Cloudinary credentials, for example in a local .env file. Never expose API secrets in client-side code.

Social

Social sizes for every channel

One source image, every aspect ratio. Smart-crop with g_auto keeps the subject centered for feeds, stories, and thumbnails.

Square crop 1:1
Portrait crop 4:5
Product photo
Ecommerce

A consistent product catalog

Automatically normalize size, background, and format across every product shot on delivery.

User-uploaded photo
User content

Let your users upload

The Upload widget handles file uploads, moderation, and more. Use it in your app to accept media from anyone.

Performance

Fast galleries, automatically

f_auto and q_auto pick the best format and quality per device, every time.

Video frame
Video

Transform and deliver video

Same pipeline as images. Resize, optimize, and stream adaptive video from a single source file.

Dive deeper

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars