[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Ideogram 3.0 Reframe](https://spiral.ai/integrations/opencode/ideogram-3-0-reframe)

# How to Use Ideogram 3.0 Reframe in opencode

Ideogram 3.0 Reframe adapts existing images for banners, social posts, and other layouts by generating space beyond their borders. It keeps the source pixels centered and fills the added area.

|  |  |
| --- | --- |
| Model | Ideogram 3.0 Reframe |
| Available through | fal |
| Category | Image |
| Price | $0.039 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Ideogram 3.0 Reframe in opencode

- Use Ideogram 3.0 Reframe to expand the homepage artwork into a landscape banner. Preview it in the existing hero component and check the generated borders.
- Find the newsletter header image in this project and use Ideogram 3.0 Reframe to make a 1280 by 720 version. Save it beside the original.
- Use Ideogram 3.0 Reframe to create square compositions from the existing article illustrations. Build a local comparison page showing each source and result.
- Use Ideogram 3.0 Reframe to expand the onboarding illustration into a portrait composition. Preview it in the mobile layout before changing the image reference.
- Use Ideogram 3.0 Reframe to prepare landscape versions of the campaign artwork. Compare faster and higher quality renders in a local preview.

## How to set up Ideogram 3.0 Reframe in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Ideogram 3.0 Reframe**: 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/ideogram/v3/reframe",
    "input": {
      "image_url": "https://v3.fal.media/files/lion/0qJs_qW8nz0wYsXhFa6Tk.png",
      "image_size": "square_hd"
    }
  }'
```

Then paste one of the prompts above: opencode finds Ideogram 3.0 Reframe on Spiral, shows the price and runs it.

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

## Ideogram 3.0 Reframe tools and prices

- [Ideogram · Reframe](https://spiral.ai/tools/fal/fal-ai/ideogram/v3/reframe) (fal): $0.039 per image with TURBO, $0.078 with BALANCED (the default), $0.117 with QUALITY.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
| rendering_speed | TURBO, BALANCED, QUALITY | BALANCED | The rendering speed to use. |
| color_palette |  | — | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
| style_codes |  | — | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
| style | AUTO, GENERAL, REALISTIC, DESIGN | — | The style type to generate with. Cannot be used with style_codes. |
| num_images | 1 to 8 | 1 | Number of images to generate. |

## What can you do with Ideogram 3.0 Reframe in opencode?

Adapt existing project artwork to the layouts your application needs. A coding agent can inspect image placements, request expanded compositions, and preview the results in context.

### Website banners

Expand an existing campaign image into a wide composition for a website banner, then check the added edges in the page layout.

### Social post adaptations

Reframe approved artwork for square, landscape, and portrait placements while retaining the central content.

### Newsletter headers

Extend a selected editorial image into a landscape header instead of cutting away its central subject.

### Presentation artwork

Expand an existing illustration for a slide background, then place slide titles separately.

### Product campaign layouts

Add surrounding image area to an existing product visual for different campaign placements. Review the generated surroundings before approval.

### Article thumbnail preparation

Adapt an article's selected image to a landscape thumbnail and compare the result with the original composition.

## Overview

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

## Ideogram 3.0 Reframe in other agents

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

## More opencode guides

- [Ideogram 3.0 Layerize Text](https://spiral.ai/integrations/opencode/ideogram-3-0-layerize-text)
- [Ideogram 3.0 Remix](https://spiral.ai/integrations/opencode/ideogram-3-0-remix)
- [Ideogram 3.0 Edit](https://spiral.ai/integrations/opencode/ideogram-3-0-edit)
- [Ideogram 3.0 Replace Background](https://spiral.ai/integrations/opencode/ideogram-3-0-replace-background)
- [Ideogram 3.0 Character Remix](https://spiral.ai/integrations/opencode/ideogram-3-0-character-remix)
- [Ideogram 3.0 Text to Image](https://spiral.ai/integrations/opencode/ideogram-3-0-text-to-image)

## Questions about Ideogram 3.0 Reframe in opencode

**Can opencode use Ideogram 3.0 Reframe?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Ideogram 3.0 Reframe like any built-in tool.

**How much does Ideogram 3.0 Reframe cost in opencode?**

$0.039 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a fal account to use Ideogram 3.0 Reframe in opencode?**

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

**How long does it take to set up Ideogram 3.0 Reframe in opencode?**

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

**Does opencode wait while Ideogram 3.0 Reframe runs?**

Ideogram 3.0 Reframe runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.

**What is Ideogram 3.0 Reframe good for?**

Use it to adapt an existing visual to a different layout, such as a banner or social post. It generates additional image area around the centered source.

**Does Ideogram 3.0 Reframe crop or stretch the original?**

Its documented operation keeps the source pixels in the center and fills the new area. Choose it when you want to expand the composition around existing content.

**What output size can I request?**

The documentation includes a custom size example of 1280 by 720 pixels. Specify both width and height when the destination needs exact dimensions.

**How should I describe a reframing request?**

Identify the source image, the destination layout, and the desired dimensions or orientation. Ask your agent to compare the added borders with the original before selecting a result.

**Can Ideogram 3.0 Reframe fix lettering or remove an object?**

Use a separate editing operation for those changes. Ideogram directs text corrections to editable text layers and object removal to Object Remover.

