[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Recraft V4 Styles](https://spiral.ai/integrations/codex/recraft-v4-styles)

# How to Use Recraft V4 Styles in Codex

Recraft V4 Styles makes consistent illustrations and photographic visuals for recurring content and routine design work. Its 1024 × 1024 square output suits digital assets; Recraft V4 Styles Pro provides 2048 × 2048 when you need more pixels.

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

## Prompts to try with Recraft V4 Styles in Codex

- Use Recraft V4 Styles and the approved illustration in this project's assets as the style reference. Generate three separate 1024 × 1024 onboarding scenes for creating a workspace, inviting a teammate, and finishing a task, with precise matching.
- Read the empty-state descriptions in this project, then use Recraft V4 Styles with our approved illustration reference. Generate a separate 1024 × 1024 image for each state, using precise matching and a clearly described central object.
- Use Recraft V4 Styles with the project's editorial reference to make three separate 1024 × 1024 article illustrations about planning, collaboration, and review. Use flexible matching and write a distinct scene for each topic.
- Use Recraft V4 Styles with the project's approved campaign reference to generate a 3072 × 1536 illustration of cyclists entering a park. Use precise matching and place the cyclists on the right, leaving the left third open for the page headline.
- Use Recraft V4 Styles with the approved photography reference in the project. Generate a 2048 × 2048 concept image of a ceramic desk lamp on a wooden table, viewed from the side, using precise matching; flag any color differences for review.

## How to set up Recraft V4 Styles in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 Recraft V4 Styles**: 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": "recraft/v4/style/text-to-image",
    "input": {
      "prompt": "Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, colorful boats in the harbor appearing toy-like, selective focus band across…"
    }
  }'
```

Then paste one of the prompts above: Codex finds Recraft V4 Styles on Spiral, shows the price and runs it.

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

## Recraft V4 Styles tools and prices

- [Recraft V4 Styles Text to Image](https://spiral.ai/tools/fal/recraft/v4/style/text-to-image) (fal): $0.0455 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | square_hd |  |
| colors |  | [] | An array of preferable colors |
| background_color |  | — | The preferable background color of the generated images. |
| style_id |  | — | The ID of an existing V4 custom style. |
| image_urls |  | — | The URLs of the style reference images. Supports PNG, JPG, and WEBP; provide between 1 and 10 images. |
| style_match | precise, flexible | — | Override how closely the generation follows the custom style. |

## What can you do with Recraft V4 Styles in Codex?

Create illustrations that follow your project's existing visual style. Use the project brief to define each scene, then place the generated raster assets in the relevant screens.

### Campaign illustrations

Use an approved campaign reference to create new scenes with a consistent rendering style. Keep the reference fixed while changing the subject and composition.

### Editorial series artwork

Give a recurring article series a recognizable look. Generate a different visual metaphor for each topic while following the same illustration reference.

### Product photography concepts

Explore product scenes that follow the lighting and rendering of an approved photography reference. Describe each product and arrangement explicitly.

### App onboarding illustrations

Create separate scenes for welcome, collaboration, and completion screens using one illustration style. Specify each scene's objects and placement in its prompt.

### Character design exploration

Explore different characters in the rendering style of an approved reference. Describe appearance, pose, and setting for each concept.

### Recurring social artwork

Generate new square illustrations for a recurring content series. Reuse the approved visual direction and check colors before publishing.

### Presentation illustrations

Create related illustrations for a presentation, with a distinct subject for each slide. Keep the reference consistent and specify space for slide text.

## Overview

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

## Recraft V4 Styles in other agents

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

## More Codex guides

- [Recraft V4 Pro Vector](https://spiral.ai/integrations/codex/recraft-v4-pro-vector)
- [Recraft V4 Styles Pro](https://spiral.ai/integrations/codex/recraft-v4-styles-pro)
- [Recraft V4 Pro](https://spiral.ai/integrations/codex/recraft-v4-pro)
- [Recraft V4 Styles Pro Vector](https://spiral.ai/integrations/codex/recraft-v4-styles-pro-vector)
- [Recraft V4](https://spiral.ai/integrations/codex/recraft-v4)
- [Recraft V4 Styles Vector](https://spiral.ai/integrations/codex/recraft-v4-styles-vector)

## Questions about Recraft V4 Styles in Codex

**Can Codex use Recraft V4 Styles?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Recraft V4 Styles like any built-in tool.

**How much does Recraft V4 Styles cost in Codex?**

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

**Do I need a fal account to use Recraft V4 Styles in Codex?**

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

**How long does it take to set up Recraft V4 Styles in Codex?**

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

**Does Codex wait while Recraft V4 Styles runs?**

Recraft V4 Styles runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.

**What is Recraft V4 Styles best for?**

Use it when several images need to share an established look, such as campaign illustrations, editorial artwork, or photographic concepts. Style matching covers photography, character design, and flat illustration.

**When should I choose precise or flexible matching?**

Choose precise when rendering, lighting, and composition need to follow the reference closely. Choose flexible when you want its general mood with more room for interpretation.

**Is one good reference enough?**

Yes. Start with one clear reference; add similar images to sharpen the match, or varied images when you want a broader range.

**Will it reproduce brand colors exactly?**

Exact color matching is not guaranteed. Compare the generated colors with your approved reference before using the image in brand work.

**What should I describe in the prompt?**

Specify the subject, setting, composition, pose, and objects you want. To create different scenes in the same style, change those details while keeping the style reference consistent.

