[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [Cartoonify](https://spiral.ai/integrations/gemini/cartoonify)

# How to Use Cartoonify in Gemini

Cartoonify turns existing photos into cartoons with bold outlines and rich colors. Use it for illustrated avatars, editorial images, and social graphics when you want a visibly drawn treatment.

|  |  |
| --- | --- |
| Model | Cartoonify |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Cartoonify in Gemini

- Use Cartoonify to turn my attached portrait into a square cartoon profile picture. Show me the result so I can check the face before using it.
- Use Cartoonify on this pet photograph to make cartoon artwork for a greeting card. Choose a portrait frame with a three-to-four shape.
- Use Cartoonify to turn this vacation photograph into an illustration for my travel journal. Use a landscape frame with a four-to-three shape.
- Use Cartoonify on this photograph for a video thumbnail. Choose a widescreen frame with a sixteen-to-nine shape; I will add the title afterward.
- Use Cartoonify to give this event photograph a cartoon treatment for a vertical social story. Choose a nine-to-sixteen shape and show me the framing.

## How to set up Cartoonify in Gemini

Pick the way that suits you. Each takes about two minutes.

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Cartoonify**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/image-editing/cartoonify",
    "input": {
      "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png"
    }
  }'
```

Then paste one of the prompts above: Gemini finds Cartoonify on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini

## Cartoonify tools and prices

- [Image Editing Cartoonify](https://spiral.ai/tools/fal/fal-ai/image-editing/cartoonify) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 0 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_inference_steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| safety_tolerance | 1, 2, 3, 4, 5, 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive. |
| output_format | jpeg, png | jpeg | The format of the generated image. |
| aspect_ratio | 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 | — | The aspect ratio of the generated image. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |

## What can you do with Cartoonify in Gemini?

Turn a photo you share in chat into cartoon artwork for a specific purpose. Your chat agent can help choose the framing and review the result before you use it.

### Illustrated profile pictures

Turn a portrait photo into a cartoon avatar. Review the face at the small size used by the destination app before choosing the final image.

### Editorial photo treatments

Convert an article's existing photograph into cartoon artwork. Add the headline and caption during page layout.

### Social post artwork

Give a campaign photograph a drawn treatment for a social post. Choose the output shape for the intended placement.

### Pet portraits

Use a pet photograph as the starting point for a cartoon portrait for a personal gallery or greeting card.

### Travel journal illustrations

Turn selected vacation photographs into cartoon illustrations for a travel journal. Keep place names and descriptive text in the surrounding layout.

### Photo-based video thumbnails

Convert a photograph into cartoon artwork for a video thumbnail. Check the result at thumbnail size, then add titles in an editor.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## Cartoonify in other agents

- [Amp](https://spiral.ai/integrations/amp/cartoonify)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/cartoonify)
- [Claude](https://spiral.ai/integrations/claude-desktop/cartoonify)
- [Claude Code](https://spiral.ai/integrations/claude-code/cartoonify)
- [Cline](https://spiral.ai/integrations/cline/cartoonify)
- [Codex](https://spiral.ai/integrations/codex/cartoonify)
- [Cursor](https://spiral.ai/integrations/cursor/cartoonify)
- [Devin](https://spiral.ai/integrations/devin/cartoonify)
- [dots](https://spiral.ai/integrations/dots/cartoonify)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/cartoonify)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/cartoonify)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/cartoonify)
- [goose](https://spiral.ai/integrations/goose/cartoonify)
- [Grok](https://spiral.ai/integrations/grok/cartoonify)
- [Grok Build](https://spiral.ai/integrations/grok-build/cartoonify)
- [Hermes](https://spiral.ai/integrations/hermes/cartoonify)
- [Instinct](https://spiral.ai/integrations/instinct/cartoonify)
- [Manus](https://spiral.ai/integrations/manus/cartoonify)
- [Muse](https://spiral.ai/integrations/muse/cartoonify)
- [Muse Code](https://spiral.ai/integrations/muse-code/cartoonify)
- [n8n](https://spiral.ai/integrations/n8n/cartoonify)
- [Notion](https://spiral.ai/integrations/notion/cartoonify)
- [OpenClaw](https://spiral.ai/integrations/openclaw/cartoonify)
- [opencode](https://spiral.ai/integrations/opencode/cartoonify)
- [Perplexity](https://spiral.ai/integrations/perplexity/cartoonify)
- [Raycast](https://spiral.ai/integrations/raycast/cartoonify)
- [VS Code](https://spiral.ai/integrations/vscode/cartoonify)
- [Windsurf](https://spiral.ai/integrations/windsurf/cartoonify)
- [Zapier](https://spiral.ai/integrations/zapier/cartoonify)

## More Gemini guides

- [Broccoli Haircut](https://spiral.ai/integrations/gemini/broccoli-haircut)
- [Chromatic Aberration](https://spiral.ai/integrations/gemini/chromatic-aberration)
- [Bria Virtual Try-On](https://spiral.ai/integrations/gemini/bria-virtual-try-on)
- [City Teleport](https://spiral.ai/integrations/gemini/city-teleport)
- [Bria Text-to-Image Base](https://spiral.ai/integrations/gemini/bria-text-to-image-base)
- [Clarity Upscaler](https://spiral.ai/integrations/gemini/clarity-upscaler)

## Questions about Cartoonify in Gemini

**Can Gemini use Cartoonify?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Cartoonify like any built-in tool.

**How much does Cartoonify cost in Gemini?**

$0.052 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini plan is separate.

**Do I need a fal account to use Cartoonify in Gemini?**

No. Spiral runs Cartoonify on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Cartoonify in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while Cartoonify runs?**

Cartoonify runs in the background. Gemini starts the run, checks on it and gives you the image when it's ready.

**What does Cartoonify do to a photo?**

It converts the photo into cartoon artwork with bold outlines and rich colors. Consider it for an illustrated profile picture or a drawn treatment of an existing photograph.

**How should I prompt Cartoonify?**

Treat the source photo as the creative brief. Choose the subject and composition before conversion, then tell your agent where you plan to use the result.

**Is Cartoonify suitable for subtle photographic retouching?**

Its stated treatment emphasizes bold outlines and rich colors. Choose it when that visible cartoon effect suits the image; for subtle retouching, look for a tool designed to preserve a photographic appearance.

**Can I reproduce a Cartoonify result?**

The documentation says the same seed and prompt produce the same image on the same model version. Keep the source image and other settings unchanged when checking reproducibility.

**What is Cartoonify's maximum output resolution?**

The documentation does not publish a maximum output resolution. Inspect the returned image dimensions before choosing a print size or enlarging the result.

