[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Recraft V4 Vector](https://spiral.ai/integrations/opencode/recraft-v4-vector)

# How to Use Recraft V4 Vector in opencode

Recraft V4 Vector turns text briefs into editable SVGs for icons, logo concepts, and simple illustrations. Use it for quick visual exploration; Recraft V4 Pro Vector targets more detailed geometry and print work.

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

## Prompts to try with Recraft V4 Vector in opencode

- Read the project's design tokens, then use Recraft V4 Vector to create a saved-items icon: one bookmark silhouette, consistent outline, centered composition, no lettering.
- Review our onboarding copy, then use Recraft V4 Vector to illustrate inviting a teammate: two simple figures sharing a document, consistent outlines, no texture or lettering.
- Use Recraft V4 Vector to explore a bird symbol for this project's identity: three solid geometric shapes, one color, centered composition. Save the SVG for review.
- Use Recraft V4 Vector to create an empty-state illustration for our search page: a magnifying glass beside an open box, flat shapes, restrained detail. Match the project's palette.
- Use Recraft V4 Vector to create botanical artwork for the product page: three interlocking leaves with clear negative space. Match our design tokens and add the SVG to the page.

## How to set up Recraft V4 Vector 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 Recraft V4 Vector**: 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/recraft/v4/text-to-vector",
    "input": {
      "prompt": "a cute character fox with cool clothes, 3d flat color, design"
    }
  }'
```

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

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

## Recraft V4 Vector tools and prices

- [Recraft V4 (Vector) Normal · Text to Vector](https://spiral.ai/tools/fal/fal-ai/recraft/v4/text-to-vector) (fal): $0.104 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. |

## What can you do with Recraft V4 Vector in opencode?

Create editable icons and illustrations for the product you are building. A coding agent can turn the project's design rules into Recraft V4 Vector briefs and place the resulting SVGs in the interface.

### Logo concept exploration

Explore a business's symbol through several text briefs, then choose a direction to refine as editable vector artwork.

### Product interface icons

Create icons for search, saved items, delivery, or other product actions. Specify the same line weight and shape rules in each brief.

### Onboarding illustrations

Illustrate actions such as creating a workspace or inviting a teammate with simple characters, clear silhouettes, and a limited palette.

### Editorial spot illustrations

Turn an article's central idea into a small vector illustration, such as a branching path for a story about career choices.

### Packaging artwork

Develop botanical symbols, geometric animals, or other flat illustrations for labels and boxes, then refine the SVG in the packaging layout.

### Poster illustrations

Create a central vector illustration for an event poster. Describe the focal shape and leave room for the event details.

### Presentation graphics

Make editable illustrations for slides about teamwork, planning, or research, using a clear visual metaphor and restrained detail.

## Overview

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

## Recraft V4 Vector in other agents

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

## More opencode guides

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

## Questions about Recraft V4 Vector in opencode

**Can opencode use Recraft V4 Vector?**

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

**How much does Recraft V4 Vector cost in opencode?**

$0.104 per image. 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 Recraft V4 Vector in opencode?**

No. Spiral runs Recraft V4 Vector 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 Vector in opencode?**

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

**Does opencode wait while Recraft V4 Vector runs?**

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

**Does Recraft V4 Vector produce actual vector files?**

Yes. Recraft V4 Vector and Recraft V4 Pro Vector produce editable SVGs that you can resize and continue editing in a vector design tool.

**What resolution are the SVGs?**

SVG output has no fixed pixel resolution. Choose between Recraft V4 Vector and Recraft V4 Pro Vector based on the detail you need, rather than treating them as 1K and 2K image exports.

**When should I choose Recraft V4 Pro Vector?**

Choose it for detailed illustrations and print artwork where path quality and geometry matter. Recraft V4 Vector is a useful starting point for icons, logo concepts, and quick illustration exploration.

**How should I write a vector prompt?**

Name the graphic you need, then describe its silhouette, palette, line style, and arrangement. For example, request a centered bird symbol made from three solid shapes with no shading.

**What should I avoid in vector prompts?**

Avoid texture and material descriptions when you want simple graphic shapes. Recraft recommends structural instructions, such as clear geometry and consistent lines, for vector work.

