[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Hi3D Image to Relief](https://spiral.ai/integrations/gemini-cli/hi3d-image-to-relief)

# How to Use Hi3D Image to Relief in Gemini CLI

Hi3D Image to Relief turns a single image into a relief depth map. Use it to prepare raised artwork concepts, with further modeling needed for a printable object.

|  |  |
| --- | --- |
| Model | Hi3D Image to Relief |
| Available through | fal |
| Category | Image |
| Price | $0.26 per run. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Hi3D Image to Relief in Gemini CLI

- Use Hi3D Image to Relief on assets/portrait.png, then save the depth map beside the source for our plaque study.
- Use Hi3D Image to Relief on assets/ornament.webp and add the result to our decorative panel review.
- Use Hi3D Image to Relief on each emblem image in assets/emblems, processing one image per generation.
- Use Hi3D Image to Relief on assets/botanical.png, then create a side-by-side view of the source and resulting depth map.
- Use Hi3D Image to Relief on assets/medallion.jpg and draft a modeling handoff covering the backing, border, and intended dimensions.

## How to set up Hi3D Image to Relief 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 Hi3D Image to Relief**: 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": "hitem3d/hi3d/image-to-relief",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/dog.png"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Hi3D Image to Relief on Spiral, shows the price and runs it.

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

## Hi3D Image to Relief tools and prices

- [Hi3D Image to Relief](https://spiral.ai/tools/fal/hitem3d/hi3d/image-to-relief) (fal): $0.26 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| remove_background |  | true | Whether to remove the image background before generation. |
| output_format | png, exr | png | File format of the generated depth map. |

## What can you do with Hi3D Image to Relief in Gemini CLI?

Create relief studies from artwork already in your project. Your coding agent can organize the results and prepare a comparison for design review.

### Portrait plaque studies

Convert a supplied portrait into a depth map to explore a raised plaque design before modeling its backing.

### Decorative wall panels

Use an artwork image as the starting point for a relief panel concept, then review the generated depth.

### Commemorative medallions

Generate a relief study from a supplied emblem image before developing the medallion's border and physical dimensions.

### Ornamental tile concepts

Turn a botanical or geometric design image into a depth map for a decorative tile study.

### Decorative box panels

Explore raised artwork for a box lid using a supplied illustration, with the lid geometry prepared separately.

### Reference image comparisons

Process alternative images separately and compare their relief results before choosing a design to develop.

## Overview

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

## Hi3D Image to Relief in other agents

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

## More Gemini CLI guides

- [Headshot Generator](https://spiral.ai/integrations/gemini-cli/headshot-generator)
- [HiDream I1 Fast](https://spiral.ai/integrations/gemini-cli/hidream-i1-fast)
- [Hair Change](https://spiral.ai/integrations/gemini-cli/hair-change)
- [HiDream I1 Full](https://spiral.ai/integrations/gemini-cli/hidream-i1-full)
- [Grok Imagine Image Quality Text to Image](https://spiral.ai/integrations/gemini-cli/grok-imagine-image-quality-text-to-image)
- [HiDream O1 Image](https://spiral.ai/integrations/gemini-cli/hidream-o1-image)

## Questions about Hi3D Image to Relief in Gemini CLI

**Can Gemini CLI use Hi3D Image to Relief?**

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

**How much does Hi3D Image to Relief cost in Gemini CLI?**

$0.26 per run. 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 Hi3D Image to Relief in Gemini CLI?**

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

**How long does it take to set up Hi3D Image to Relief in Gemini CLI?**

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

**Does Gemini CLI wait while Hi3D Image to Relief runs?**

Hi3D Image to Relief runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What does Hi3D Image to Relief produce?**

It produces a relief depth map from a single image. Treat the result as material for further relief design and preparation.

**Can I print the result directly?**

The documented output is a depth image. Plan a separate modeling step to turn it into the printable geometry your project needs.

**What reference image should I choose?**

Follow Hi3D's guidance: choose a clear, well-lit image with the whole subject visible and a simple background. Avoid references where other objects obscure the subject.

**How large can the source image be?**

The documented input limit is 20 MB. PNG, JPEG, and WebP images are supported.

**What projects could I try first?**

Try a relief study for a portrait plaque, ornamental tile, or commemorative medallion. These are suggested applications of its image-to-relief capability; review the depth map before developing the physical design.

