[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Kokoro American English](https://spiral.ai/integrations/opencode/kokoro-american-english)

# How to Use Kokoro American English in opencode

Kokoro American English turns written scripts into US English speech for explainers, lessons, and narrated updates. Use it for paragraph-length narration, and split longer scripts to reduce rushed delivery.

|  |  |
| --- | --- |
| Model | Kokoro American English |
| Available through | fal |
| Category | Audio |
| Price | Each item in `prompt` adds $0.026. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Kokoro American English in opencode

- Read the README and draft a short spoken introduction to the project. Generate it with Kokoro American English at normal speed, keeping code snippets out of the narration.
- Use the latest changelog to write a spoken summary of three user-facing changes. Generate separate passages with Kokoro American English and save the scripts beside the audio.
- Turn the onboarding guide into a narrated walkthrough with Kokoro American English. Divide it at topic boundaries and keep the same voice throughout.
- Find the demo script in this project. Generate one passage with Kokoro American English at speed 1.0 and again at 0.9 so I can compare the pacing.
- Review the tutorial files and draft a spoken explanation of the main workflow. Use Kokoro American English for the narration, splitting long passages before generation.

## How to set up Kokoro American English 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 Kokoro American English**: 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/kokoro/american-english",
    "input": {
      "prompt": ""
    }
  }'
```

Then paste one of the prompts above: opencode finds Kokoro American English on Spiral, shows the price and runs it.

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

## Kokoro American English tools and prices

- [Kokoro TTS · American English](https://spiral.ai/tools/fal/fal-ai/kokoro/american-english) (fal): $0.026 per 1,000 characters of `prompt`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  |  |  |
| voice | af_heart, af_alloy, af_aoede, af_bella, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky, am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck, am_santa | af_heart | Voice ID for the desired voice. |
| speed | 0.1 to 5 | 1 | Speed of the generated audio. Default is 1.0. |

## What can you do with Kokoro American English in opencode?

Turn project documentation and release notes into spoken walkthroughs with Kokoro American English. Have the agent prepare narration from the files, then generate manageable passages for review.

### Product explainer narration

Turn an approved product explanation into US English speech. Generate each section separately so you can revise individual passages.

### Audio editions of articles

Create spoken versions of finished articles, dividing the text into manageable passages for listening and review.

### Training lesson narration

Narrate short lesson sections and compare normal delivery with a slower reading before choosing the final audio.

### Spoken daily briefings

Convert a prepared daily summary into speech, keeping each topic in its own passage.

### Release note summaries

Make an audio summary of product changes after an agent has rewritten the release notes for spoken delivery.

### Narration draft reviews

Listen to a script before recording the final production. Compare wording and pacing using the same voice across drafts.

## Overview

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

## Kokoro American English in other agents

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

## More opencode guides

- [Kling Video to Audio](https://spiral.ai/integrations/opencode/kling-video-to-audio)
- [Kokoro Brazilian Portuguese](https://spiral.ai/integrations/opencode/kokoro-brazilian-portuguese)
- [Kling TTS](https://spiral.ai/integrations/opencode/kling-tts)
- [Kokoro British English](https://spiral.ai/integrations/opencode/kokoro-british-english)
- [Kling Create Voice](https://spiral.ai/integrations/opencode/kling-create-voice)
- [Kokoro French](https://spiral.ai/integrations/opencode/kokoro-french)

## Questions about Kokoro American English in opencode

**Can opencode use Kokoro American English?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Kokoro American English like any built-in tool.

**How much does Kokoro American English cost in opencode?**

Each item in `prompt` adds $0.026. 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 Kokoro American English in opencode?**

No. Spiral runs Kokoro American English on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Kokoro American English in opencode?**

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

**Does opencode wait while Kokoro American English runs?**

Kokoro American English runs in the background. opencode starts the run, checks on it and gives you the audio when it's ready.

**What is Kokoro American English useful for?**

Use it to turn finished English scripts into spoken explainers, lessons, article narration, or updates. Prepare the wording before generating the speech.

**How much text should I generate at once?**

The maker recommends roughly 100 to 200 tokens per passage for most voices. Treat that as guidance for individual passages, rather than a maximum length for an entire project.

**Why does a long passage sound rushed?**

The maker flags rushing above about 400 tokens. Try splitting the passage first, then reduce the speaking speed if needed.

**Are the token recommendations word counts?**

No. Kokoro processes phonemes, so 100 words should not be treated as 100 model tokens.

**What sample rate does Kokoro use?**

The maker's reference implementation uses 24 kHz for generated speech. That is the reference audio rate, rather than a promise about every exported file format.

