[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Hedra Character 3](https://spiral.ai/integrations/codex/hedra-character-3)

# How to Use Hedra Character 3 in Codex

Hedra Character 3 turns a portrait and recorded speech or singing into a lip-synced video. Use it for seated presenters, lessons, and character narration, with restrained movement directions.

|  |  |
| --- | --- |
| Model | Hedra Character 3 |
| Available through | Hedra |
| Category | Video |
| Price | $0.065 per second at 720p ($0.0325 at 540p, $0.0813 at 1080p), for the audio's length. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Hedra Character 3 in Codex

- Use Hedra Character 3 with the approved presenter portrait and 20-second release narration in this project. Make a 720p announcement with seated posture, hands resting, and a stationary camera.
- Use Hedra Character 3 to animate the project's teacher portrait with its 25-second tutorial recording at 720p. Request patient delivery, small head movements, and resting hands.
- Use Hedra Character 3 with the illustrated host image and 15-second podcast excerpt in the project. Create a 720p clip with relaxed delivery and limited body movement.
- Use Hedra Character 3 to create separate 20-second presenter clips from the project's approved portrait and English and Spanish narration recordings. Render at 720p with the same seated performance directions.
- Use Hedra Character 3 with the clay character portrait and 12-second vocal recording in this project. Create a 720p singing clip with gentle head movement and a stationary camera.

## How to set up Hedra Character 3 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 Hedra Character 3**: 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": "hedra",
    "model": "hedra-character-3",
    "input": {
      "audio": {
        "url": "<url>",
        "source": "url"
      },
      "prompt": "Generate a realistic talking avatar video with lip sync",
      "resolution": "720p",
      "start_image": {
        "url": "<url>",
        "source": "url"
      },
      "aspect_ratio": "9:16"
    }
  }'
```

Then paste one of the prompts above: Codex finds Hedra Character 3 on Spiral, shows the price and runs it.

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

## Hedra Character 3 tools and prices

- [Hedra Character-3 · Talking Avatar Video](https://spiral.ai/tools/hedra/hedra-character-3) (Hedra): $0.065 per second at 720p ($0.0325 at 540p, $0.0813 at 1080p), for the audio's length.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| duration_ms | … to 600000 | — | Duration in ms. At most 600000. |
| bounding_box_target |  | — | Speaker position in the start frame, as normalized [x, y] image coordinates (0-1 from the top-left); selects who speaks in a frame with several people. |

## What can you do with Hedra Character 3 in Codex?

Turn project narration and character artwork into presenter videos for lessons, release announcements, or onboarding. A coding agent can select the project assets and prepare restrained performance directions for Hedra Character 3.

### Short teaching videos

Animate a teacher portrait with a recorded explanation of one concept. Use patient delivery, resting hands, and a stationary camera.

### Character-led product announcements

Turn a character portrait and an approved launch recording into a seated presenter clip for a product announcement.

### Animated podcast excerpts

Pair an illustrated host portrait with a short spoken excerpt to make a talking podcast clip.

### Bedtime storytelling

Animate a narrator portrait with a gentle story recording. Request still framing and slow, subtle head movement.

### Singing character clips

Give a claymation character portrait a short vocal performance using a recorded song excerpt.

### News-style briefings

Animate an anchor portrait with a recorded bulletin, using seated posture and restrained gestures.

### Localized presenter videos

Create talking presenter clips from an approved portrait and separate narration recordings in the intended languages.

## Overview

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

## Hedra Character 3 in other agents

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

## More Codex guides

- [Happy Horse Video Edit](https://spiral.ai/integrations/codex/happy-horse-video-edit)
- [HeyGen Avatar III Digital Twin](https://spiral.ai/integrations/codex/heygen-avatar-iii-digital-twin)
- [Happy Horse 1.1 Text to Video](https://spiral.ai/integrations/codex/happy-horse-1-1-text-to-video)
- [HeyGen Avatar IV](https://spiral.ai/integrations/codex/heygen-avatar-iv)
- [Happy Horse 1.1 Reference to Video](https://spiral.ai/integrations/codex/happy-horse-1-1-reference-to-video)
- [HeyGen Avatar IV Digital Twin](https://spiral.ai/integrations/codex/heygen-avatar-iv-digital-twin)

## Questions about Hedra Character 3 in Codex

**Can Codex use Hedra Character 3?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Hedra Character 3 like any built-in tool.

**How much does Hedra Character 3 cost in Codex?**

$0.065 per second at 720p ($0.0325 at 540p, $0.0813 at 1080p), for the audio's length. 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 Hedra account to use Hedra Character 3 in Codex?**

No. Spiral runs Hedra Character 3 on its own Hedra account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Hedra Character 3 in Codex?**

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

**Does Codex wait while Hedra Character 3 runs?**

Hedra Character 3 runs in the background. Codex starts the run, checks on it and gives you the video when it's ready.

**What is Hedra Character 3 best at?**

Hedra Character 3 is a good fit for seated talking heads: teachers, presenters, narrators, and podcast hosts. Its examples emphasize speech delivery with limited body movement.

**How long can Hedra Character 3 videos be, and what resolutions are listed?**

Hedra advertises a maximum duration of 10 minutes and lists 540p, 720p, and 1080p output. Those headline specifications do not establish that every resolution supports the full maximum duration.

**Does Hedra Character 3 support languages other than English?**

Hedra advertises multilingual support for talking and singing videos. Use narration recorded in the intended language.

**How should I prompt movement in Hedra Character 3?**

Describe the performance directly: seated posture, hands resting, small head movements, and a stationary camera. Hedra uses these directions in its own teacher example.

**What can make Hedra Character 3 results look unnatural?**

Hedra flags exaggerated hand gestures as a known quirk and recommends explicitly restraining movement in the prompt. It also recommends clearly pronounced speech without background noise or heavy reverb.

