[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Kling O3 Pro Reference to Video](https://spiral.ai/integrations/codex/kling-o3-pro-reference-to-video)

# How to Use Kling O3 Pro Reference to Video in Codex

Build scenes around recognizable characters, objects, and environments supplied as references. Compared with Kling O3 Standard Reference to Video, Pro emphasizes higher output quality.

|  |  |
| --- | --- |
| Model | Kling O3 Pro Reference to Video |
| Available through | fal |
| Category | Video |
| Price | $0.182 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Kling O3 Pro Reference to Video in Codex

- Use Kling O3 Pro Reference to Video with the product reference images in this project. Create an 8-second scene of the product on a pale stone shelf, with a slow camera move and soft window light.
- Estimate, then generate a 5-second 9:16 clip with Kling O3 Pro Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Kling O3 Pro Reference to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Kling O3 Pro Reference to Video and list what each cost.
- Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Kling O3 Pro Reference to Video.

## How to set up Kling O3 Pro Reference to Video 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 Kling O3 Pro Reference to Video**: 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-video/o3/pro/reference-to-video",
    "input": {
      "prompt": "@Element1 and @Element2 enters the scene from two sides. Elephant starts to play with the ball"
    }
  }'
```

Then paste one of the prompts above: Codex finds Kling O3 Pro Reference to Video on Spiral, shows the price and runs it.

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

## Kling O3 Pro Reference to Video tools and prices

- [Kling O3 Reference to Video Pro · Reference I2V](https://spiral.ai/tools/fal/fal-ai/kling-video/o3/pro/reference-to-video) (fal): $0.182 per second. Billed on `duration`, default 5.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | — | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both. |
| multi_prompt |  | — | List of prompts for multi-shot video generation. |
| start_image_url |  | — | Image to use as the first frame of the video. |
| end_image_url |  | — | Image to use as the last frame of the video. |
| image_urls |  | — | Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video. |
| elements |  | — | Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2. |

## What can you do with Kling O3 Pro Reference to Video in Codex?

Turn a project's creative brief and visual assets into short scenes or footage revisions with Kling O3. Keep the intended action and visual direction beside the project so each result can be reviewed against the brief.

### Product reveal concepts

Create or revise a short product scene to test framing, lighting, and the reveal before committing to a campaign.

### Storyboard scene tests

Explore a scene's blocking, composition, and visual direction through generated shots or revisions to existing footage.

### Stylized short scenes

Develop a brief illustrated or anime scene, either by generating footage or restyling a supplied clip.

### Setting and mood studies

Test how a short scene reads in different environments, weather, or lighting before selecting its visual direction.

### Illustrations in motion

Start with an illustration and direct a short gesture, expression change, or camera move.

### Recognizable character and product scenes

Use visual references to direct recognizable subjects in a new scene or replace subjects in existing footage.

## Overview

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

## Kling O3 Pro Reference to Video in other agents

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

## More Codex guides

- [Kling O3 Pro Image to Video](https://spiral.ai/integrations/codex/kling-o3-pro-image-to-video)
- [Kling O3 Pro Text to Video](https://spiral.ai/integrations/codex/kling-o3-pro-text-to-video)
- [Kling O3 4K Video Editing](https://spiral.ai/integrations/codex/kling-o3-4k-video-editing)
- [Kling O3 Pro Video Editing](https://spiral.ai/integrations/codex/kling-o3-pro-video-editing)
- [Kling O3 4K Text to Video](https://spiral.ai/integrations/codex/kling-o3-4k-text-to-video)
- [Kling O3 Reference Video to Video 4K](https://spiral.ai/integrations/codex/kling-o3-reference-video-to-video-4k)

## Questions about Kling O3 Pro Reference to Video in Codex

**Can Codex use Kling O3 Pro Reference to Video?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Kling O3 Pro Reference to Video like any built-in tool.

**How much does Kling O3 Pro Reference to Video cost in Codex?**

$0.182 per second. Billed on `duration`, default 5. 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 Kling O3 Pro Reference to Video in Codex?**

No. Spiral runs Kling O3 Pro Reference to Video 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 O3 Pro Reference to Video in Codex?**

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

**Does Codex wait while Kling O3 Pro Reference to Video runs?**

Kling O3 Pro Reference to Video runs in the background. Codex starts the run, checks on it and gives you the video when it's ready.

**What is Kling O3 useful for?**

Use Kling O3 for short advertising scenes, storyboard experiments, and visual storytelling. Choose a concrete scene to create or revise, such as a product reveal or a character entering a room.

**How long should I plan each scene?**

Plan around short clips: generation supports 3 to 15 seconds, and video editing accepts footage within that range. Break a longer story into separate scenes.

**What should a Kling O3 prompt describe?**

Describe the subject, visible action, setting, lighting, and camera intention. When revising footage, state the exact change and what you want preserved.

**What should I review before using a clip?**

Watch the entire clip and check whether the intended action, appearance, and camera direction hold throughout. Treat requests to preserve details as instructions to verify during review.

**Is Kling O3 the same as Kling VIDEO 3.0 Omni?**

Yes. Kling O3 is the name used for VIDEO 3.0 Omni, which follows Kling O1.

