[Integrations](https://spiral.ai/integrations) › [Raycast](https://spiral.ai/integrations/raycast) › [Kling O1 Image](https://spiral.ai/integrations/raycast/kling-o1-image)

# How to Use Kling O1 Image in Raycast

Kling O1 Image edits and combines reference images while preserving recognizable subjects and visual style. Use it for product scenes, character artwork, and targeted changes to existing images, with output up to 2K.

|  |  |
| --- | --- |
| Model | Kling O1 Image |
| Available through | fal |
| Category | Image |
| Price | `resolution`: 1K (default) $0.0364, 2K $0.0364 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 Kling O1 Image in Raycast

- Use Kling O1 Image to put the bottle from my first reference on the table in my second reference. Preserve the bottle's shape and label design, and match the scene's lighting.
- Use Kling O1 Image to change only the jacket in this portrait from blue to dark green. Keep the face, pose, background, and lighting unchanged.
- Use Kling O1 Image to turn this character illustration into a felt figure. Keep its colors, silhouette, and expression recognizable.
- Use Kling O1 Image to create a side view of this character. Preserve the hairstyle, costume, and color palette.
- Use Kling O1 Image to apply the painting style from my second image to the scene in my first image. Keep the scene's composition and produce a 2K landscape image.

## How to set up Kling O1 Image in Raycast

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

### Use the Raycast connector

1. **Install the server**: In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

### Use the Spiral skill

1. **Send Raycast 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 Kling O1 Image**: 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/kling-image/o1",
    "input": {
      "prompt": "Put @Image1 to the back seat of the car in @Image2, put @Element1 on to the @Image1",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Raycast finds Kling O1 Image on Spiral, shows the price and runs it.

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

## Kling O1 Image tools and prices

- [Kling O1 Image](https://spiral.ai/tools/fal/fal-ai/kling-image/o1) (fal): `resolution`: 1K (default) $0.0364, 2K $0.0364 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| elements |  | — | Elements (characters/objects) to include in the image. Reference in prompt as @Element1, @Element2, etc. Maximum 10 total (elements + reference images). |
| resolution | 1K, 2K | 1K | Image generation resolution. 1K: standard, 2K: high-res. |
| num_images | 1 to 9 | 1 | Number of images to generate (1-9). |
| aspect_ratio | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | auto | Aspect ratio of generated images. 'auto' intelligently determines based on input content. |
| output_format | jpeg, png, webp | png | The format of the generated image. |

## What can you do with Kling O1 Image in Raycast?

Explore visual changes by describing them in everyday language. A chat app can turn supplied references into edited scenes and help refine the next instruction.

### Product scene concepts

Place a reference product into a new setting for a campaign concept.

### Character views

Create alternate views of a reference character for a storyboard.

### Portrait edits

Change a portrait's background, clothing, or expression.

### Style studies

Apply a reference style to existing artwork.

### Clothing concepts

Combine a person reference with a clothing reference.

### Material studies

Explore glass, wood, or fabric treatments on a reference object.

## Overview

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

## Kling O1 Image in other agents

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

## More Raycast guides

- [Kling Image 4.0 Text to Image](https://spiral.ai/integrations/raycast/kling-image-4-0-text-to-image)
- [Kling O3 Image to Image](https://spiral.ai/integrations/raycast/kling-o3-image-to-image)
- [Kling Image 4.0 Long Image](https://spiral.ai/integrations/raycast/kling-image-4-0-long-image)
- [Kling O3 Text to Image](https://spiral.ai/integrations/raycast/kling-o3-text-to-image)
- [Kling Image 4.0 Image to Image](https://spiral.ai/integrations/raycast/kling-image-4-0-image-to-image)
- [Krea 2 Large](https://spiral.ai/integrations/raycast/krea-2-large)

## Questions about Kling O1 Image in Raycast

**Can Raycast use Kling O1 Image?**

Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run Kling O1 Image like any built-in tool.

**How much does Kling O1 Image cost in Raycast?**

`resolution`: 1K (default) $0.0364, 2K $0.0364 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 Raycast plan is separate.

**Do I need a fal account to use Kling O1 Image in Raycast?**

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

**How long does it take to set up Kling O1 Image in Raycast?**

About two minutes: install the server, then sign in to Spiral and approve.

**Does Raycast wait while Kling O1 Image runs?**

Kling O1 Image runs in the background. Raycast starts the run, checks on it and gives you the image when it's ready.

**What is Kling O1 Image good at?**

Reference-guided composition and editing: product scenes, character artwork, and changes to specific objects or details.

**Can Kling O1 Image transfer a visual style?**

Yes. Give it a content reference and a style reference, then specify which image supplies each.

**How should I prompt a targeted edit?**

Identify the object and the exact change. State which features should stay unchanged, and keep the prompt under 2,500 characters.

**What can make Kling O1 Image miss an instruction?**

Ambiguous directions can cause incorrect output. Describe the final position or orientation explicitly.

**How large are Kling O1 Image outputs?**

Outputs reach 2K resolution. Use 2K when you need a larger image for the intended placement.

