Hi folks, Jarod here. I recently joined Sanity as Head of Developer Experience and Community and as part of my onboarding I wanted to play around with some of the newer AI features released inside of Sanity. This post came from that exploration.

I’ve been on a meal plan since earlier this winter, created by my nutritional coach. It’s been great, I’ve lost 25 lbs, but it’s also been complex because I’m the one who cooks and it can be hard to shape a strict meal plan for a family. I wanted an app that could take the PDFs my coach sends, turn them into structured content in Sanity, and support workflows like scaled ingredients for my wife and kids, calculated weights, and search (we use Sanity + Algolia for that).

One thing was missing: pictures. When my family picked dinner or the kids chose a weekend breakfast, there was nothing to look at. So when I learned that Sanity shipped an Agent API action for generating images, one that reads your schema and uses your actual content to drive the prompt, I decided I needed to give it a spin. It did a phenomenal job. Here’s how to do it on an existing schema, with code and a couple of gotchas.

Prerequisites

• A Sanity project (which you can spin up here) with a document type that has an image (or image array) field.

Note on cost: Each generate call uses about 2 AI credits. Every Sanity org gets 100 free credits per month, so a batch of 50 recipes will use most of your free allotment. Check usage in Manage → Settings.

Generating an image with Sanity Agent API in Typescript

Here's the complete script, ready to copy and run. It uses getCliClient(), which pulls your project config from sanity.cli.ts and your local authenticated session so there's no manual token management or hardcoded project IDs. To run it:

A few things worth knowing before you run it:

• It targets drafts only. The Agent API writes to the draft version of a document. You'll need to publish after (more on that below).
• It uses async: true, which means the script queues the generation and returns immediately — it doesn't wait for the image to be ready. Check Studio after a minute or two to see results.
• It's safe to re-run. The GROQ filter images == null means it only processes recipes without images, so running it again won't duplicate or overwrite anything.

Don't forget to publish

Generated images land in drafts so they won't appear on your site until the document is published. This is intentional: Sanity keeps AI-generated content in draft so a human can review before anything goes live. For a personal meal planner, that's probably fine - just open Studio, eyeball the pancakes, and hit publish.

If you'd rather skip the review step entirely and publish programmatically, you can fire a publish action from the client right after generation:

Add that after the generate call (drop async: true, or wait a beat for the image to be ready) and the whole pipeline runs end to end without touching Studio.

Before: Recipes Without Images

Without real photos, even the tastiest recipes didn’t look nearly as appealing, and it was tough for family members (especially the kids) to pick what they wanted.

After: Recipes With AI-Generated Food Photos

“Wow, I want pancakes!”

Summary

So that’s how I wired up AI-generated recipe images in my Sanity meal planner, no schema changes needed, just a patch to pop in the image slot and then Generate does its thing, using the recipe’s title to make sure every photo matches the dish.

Generating appetizing images instantly made the whole meal planner feel polished and so much more fun to use. It’s a great example of how integrating AI into your content operations can speed things along and improve the whole feeling of the app.

Now, when my kids flip through the recipes, they can actually see the coconut pancakes (and everything else) before they put in their “order.” Way more appetizing for everyone- especially the picky eaters!

Taking this further at work

If you're doing something like this in a professional context and backfilling images across thousands of documents in a production dataset, you'd want to reach for Sanity's content migration tooling rather than a one-off script. The CLI migration runner handles batching, dry runs, and rollback-safe execution out of the box, which matters a lot when you're touching production content at scale. The Handling schema changes confidently course on Sanity Learn is a solid place to start if you want to get comfortable with that workflow.

If you want to take a spin through the meal-planning app you can check it out on Github. If you build something with the Agent API, we'd love to see it. Come share it on Discord in the #showcase channel.

Bonus: Alt text