[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Pixelcut Product Photo](https://spiral.ai/integrations/gemini-cli/pixelcut-product-photo)

# How to Use Pixelcut Product Photo in Gemini CLI

Pixelcut Product Photo turns an existing product shot into a cutout or catalog image. Use it to replace backgrounds and add shadows; translucent products such as glass are a documented weakness.

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

## Prompts to try with Pixelcut Product Photo in Gemini CLI

- Use Pixelcut Product Photo on the opaque product photos in public/products/source. Create 1024 × 1024 images with white backgrounds and save them in public/products/catalog.
- Use Pixelcut Product Photo to turn the backpack photo in assets/source into a transparent PNG for the storefront's promotional layout.
- Use Pixelcut Product Photo to place the shoe photo in assets/products onto the supplied campaign background in assets/campaigns. Save a 1024 × 1024 result.
- Use Pixelcut Product Photo to prepare the ceramic mug photo in public/source on a white background with an AI-generated shadow. Let the light direction be estimated from the photo.
- Use Pixelcut Product Photo on the sharpest opaque product images in assets/catalog. Export transparent PNGs into assets/cutouts and list the files created.

## How to set up Pixelcut Product Photo in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Pixelcut Product Photo**: 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": "pixelcut/product-photo",
    "input": {
      "image_url": "https://cdn3.pixelcut.app/fal/product-photos/input.png"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Pixelcut Product Photo on Spiral, shows the price and runs it.

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

## Pixelcut Product Photo tools and prices

- [Pixelcut Product Photo](https://spiral.ai/tools/fal/pixelcut/product-photo) (fal): $0.0312 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | square_hd | Output canvas size. A preset (square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9) or a custom {width, height}. Defaults to square_hd (1024x1024). |
| background |  | — | Output background: solid color (default white), transparent, or an image. |
| margin |  | — | Canvas margins around the product: `all` for every side plus optional per-side overrides. Defaults to 20% on all sides. |
| shadow |  | — | Shadow: choose a type ('Generative'/'Drop'; unset = no shadow) and set its params. |
| watermark |  | — | Optional logo/watermark image overlaid on top of the output. Off by default; omit for no watermark. |
| output_format | png, jpeg | — | The format of the resultant image (PNG or JPEG). When not set, matches the input format. JPEG cannot be combined with a transparent background. |

## What can you do with Pixelcut Product Photo in Gemini CLI?

Prepare product assets for a storefront directly from the project's existing photos. A coding agent can use Pixelcut Product Photo to create consistent catalog images and save transparent cutouts alongside the site's other assets.

### Product listing images

Prepare an existing product photo against a white background for a store listing.

### Consistent catalog grids

Give product photos the same canvas dimensions and background treatment before arranging them in a catalog grid.

### Reusable product cutouts

Create transparent PNGs of opaque products for use in layouts and presentations.

### Seasonal campaign images

Place an existing product shot onto a supplied seasonal background image.

### Social product posts

Prepare square product images with a consistent background for a sequence of social posts.

### Email promotion assets

Create isolated product images that a designer can place into promotional email layouts.

## Overview

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

## Pixelcut Product Photo in other agents

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

## More Gemini CLI guides

- [Pixelcut Background Remover](https://spiral.ai/integrations/gemini-cli/pixelcut-background-remover)
- [Plushie Style](https://spiral.ai/integrations/gemini-cli/plushie-style)
- [Photography Effects](https://spiral.ai/integrations/gemini-cli/photography-effects)
- [Portrait Enhance](https://spiral.ai/integrations/gemini-cli/portrait-enhance)
- [Photo Restoration fal](https://spiral.ai/integrations/gemini-cli/photo-restoration-fal)
- [Post Processing Color Correction](https://spiral.ai/integrations/gemini-cli/post-processing-color-correction)

## Questions about Pixelcut Product Photo in Gemini CLI

**Can Gemini CLI use Pixelcut Product Photo?**

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

**How much does Pixelcut Product Photo cost in Gemini CLI?**

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

**Do I need a fal account to use Pixelcut Product Photo in Gemini CLI?**

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

**How long does it take to set up Pixelcut Product Photo in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Pixelcut Product Photo runs?**

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

**What is Pixelcut Product Photo best for?**

Preparing existing product photos for listings and catalogs. Its background removal makes it useful for isolating products and placing them into a consistent visual treatment.

**What source photos give the best results?**

Use sharp photos with clear contrast between the product and its background. Avoid tiny thumbnails and heavily compressed JPEGs.

**Can Pixelcut Product Photo handle glass products?**

Pixelcut documents translucent materials such as glass as unsupported by its background removal. Choose an opaque product for this workflow.

**What output size should I request?**

The default canvas is 1024 × 1024 pixels, and custom dimensions are supported. Match the canvas to the intended placement so you can judge the product's framing at the size you need.

**How can I make generated shadows match the photo?**

Start by letting Pixelcut estimate the light direction from the source image. Check whether the resulting shadow agrees with the highlights on the product before using the image.

