Today, writing documentation means writing for AI. Your IDE, your LLMs, your internal tools… They all read our docs. So yes, we make sure our content is structured, accurate, and optimized for machine consumption.
But at Cloudinary, we haven’t forgotten our main reader: you.
You still come to our docs to learn, experiment, build, and engage…and ideally enjoy the process.
That’s why we’ve added something new to the Cloudinary docs: an interactive mystery game that teaches you how things work while you play.
If you enjoyed learning about Cloudinary through Clara Denari and the Mysterious Transformations, you’ll love what comes next.
This time, the mystery isn’t on a standalone site. It’s woven directly into the docs.
The new mystery begins with a small neighborhood dispute. Clara discovers a pair of sapphire earrings in her backyard. Her neighbor insists they’re a treasured family heirloom and produces an old photograph as proof.
There’s just one issue: the image is too blurry to confirm anything.
And that’s where Cloudinary comes in.
To advance the story, you don’t just read about uploads. You actually execute one. A multi-parameter upload that applies AI-powered restoration to recover details from the faded photograph. You inspect the response. You check the result. You decide whether the evidence holds up.
The narrative moves forward only when you do.
But restoring the photo isn’t enough.
To determine whether the earrings truly match, you’ll need to dig deeper, isolating the relevant details, transforming the image to focus on what matters, and applying analysis to extract meaningful visual information.
Cropping becomes part of the investigation. Color analysis becomes part of the proof. Transformations become your forensic tools.
By the time you reach the end of the case, you’ve worked through a realistic, multi-step media workflow — complex uploads, restoration, targeted transformations, and image analysis — diving deeper into features as the mystery leads you across the docs.
And ideally, without even realizing how much you’ve learned along the way.
By the time you solve Clara Denari’s latest case, you won’t just know whether the earrings match.
You’ll know how to:
- Apply AI-powered restoration during upload and understand how uploads can be customized by combining multiple parameters in a single request.
- Use AI object detection (
e_extract:prompt_object) to isolate specific elements and see how advanced transformations can refine and focus your assets with precision. - Extract dominant colors (
colors: true) for analysis and recognize how upload-time analysis can be layered into more complex media workflows.
In other words, you won’t just read about powerful features… You’ll use them.
And because the mystery spans multiple sections of the docs, you’ll naturally move from upload customization to deeper transformation and analysis capabilities, seeing how they connect in a real workflow.
If you’ve ever skimmed documentation and thought, “I’ll try that later,” this is your chance to try it now.
Start in the Upload guide.
Follow the clues.
See where they lead.
Crack the mystery. Master Cloudinary.
