[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Kokoro Japanese](https://spiral.ai/integrations/gemini-cli/kokoro-japanese)

# How to Use Kokoro Japanese in Gemini CLI

Kokoro Japanese turns Japanese scripts into speech for lessons, explainers, and narration. Preview very short lines and split long passages to check for weak delivery or rushing.

|  |  |
| --- | --- |
| Model | Kokoro Japanese |
| 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 Japanese in Gemini CLI

- Use Kokoro Japanese to narrate the Japanese onboarding guide in this repository. Remove Markdown formatting from the spoken script, record each section separately, and save a script-to-audio index.
- Read the latest changelog and draft a concise Japanese release briefing. Generate it with Kokoro Japanese at normal speaking speed and save the approved script beside the recording.
- Find the Japanese tutorial scripts in this project and generate narration with Kokoro Japanese. Preserve their order and flag any script that needs editorial review before recording.
- Use Kokoro Japanese to create two recordings of the first paragraph of our Japanese product tour, with speed set to 1.0 and 0.9. Save both with descriptive filenames for listening review.
- Prepare audio readings of the Japanese help articles in this repository with Kokoro Japanese. Divide articles at section boundaries and keep a manifest linking each recording to its article and heading.

## How to set up Kokoro Japanese in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Japanese**: 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/japanese",
    "input": {
      "prompt": "夢を追いかけることを恐れないでください。努力すれば、必ず道は開けます！",
      "voice": "jf_alpha"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Kokoro Japanese on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Kokoro Japanese tools and prices

- [Kokoro TTS (Japanese)](https://spiral.ai/tools/fal/fal-ai/kokoro/japanese) (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 |
| --- | --- | --- | --- |
| speed | 0.1 to 5 | 1 | Speed of the generated audio. Default is 1.0. |

## What can you do with Kokoro Japanese in Gemini CLI?

Create Japanese narration from your project's tutorials, release notes, and help content. A coding agent can prepare the scripts and keep recordings matched to the source text.

### Japanese tutorial narration

Record a Japanese walkthrough one task at a time, then place each passage beside the matching screen recording.

### Listening practice

Turn a Japanese lesson passage into audio and compare recordings at normal and slightly slower speaking speeds.

### Article readings

Create spoken Japanese editions of articles, recording sections separately for review and assembly.

### Product explainer drafts

Record a Japanese product explanation to check wording and timing before editing the video.

### Visitor announcements

Prepare Japanese welcome messages and visitor instructions, then review the recordings before using them.

### Recurring spoken briefings

Convert an approved Japanese daily or weekly summary into a spoken briefing with the script kept alongside it.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Kokoro Japanese in other agents

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

## More Gemini CLI guides

- [Kokoro Italian](https://spiral.ai/integrations/gemini-cli/kokoro-italian)
- [Kokoro Mandarin Chinese](https://spiral.ai/integrations/gemini-cli/kokoro-mandarin-chinese)
- [Kokoro Hindi](https://spiral.ai/integrations/gemini-cli/kokoro-hindi)
- [Kokoro TTS Spanish](https://spiral.ai/integrations/gemini-cli/kokoro-tts-spanish)
- [Kokoro French](https://spiral.ai/integrations/gemini-cli/kokoro-french)
- [Kotoba STT](https://spiral.ai/integrations/gemini-cli/kotoba-stt)

## Questions about Kokoro Japanese in Gemini CLI

**Can Gemini CLI use Kokoro Japanese?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Kokoro Japanese like any built-in tool.

**How much does Kokoro Japanese cost in Gemini CLI?**

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 Gemini CLI plan is separate.

**Do I need a fal account to use Kokoro Japanese in Gemini CLI?**

No. Spiral runs Kokoro Japanese 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 Japanese in Gemini CLI?**

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

**Does Gemini CLI wait while Kokoro Japanese runs?**

Kokoro Japanese runs in the background. Gemini CLI starts the run, checks on it and gives you the audio when it's ready.

**What is Kokoro Japanese useful for?**

Use it to turn finished Japanese scripts into spoken lessons, tutorial narration, announcements, or article readings. Prepare the wording before generating speech.

**Why can a very short line sound weak?**

The author flags weaker results below roughly 10 to 20 tokens. Try recording several related sentences together, then trimming the audio afterward.

**How should I handle a long Japanese script?**

Generate it in sections and check each recording before joining them. The reference implementation targets roughly 400 characters per non-English chunk, but that is not a published request limit.

**How do I choose the speaking speed?**

Start at the default speed, then compare a slightly slower recording of the same passage. Review both before processing the full script.

**What audio sample rate does Kokoro use?**

The maker's reference example writes WAV files at 24 kHz. Check the returned recording's metadata before combining it with other audio.

