[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Kokoro Mandarin Chinese](https://spiral.ai/integrations/muse-code/kokoro-mandarin-chinese)

# How to Use Kokoro Mandarin Chinese in Muse Code

Kokoro Mandarin Chinese turns Chinese scripts into speech for lessons, explainers, and narrated articles. Start with short paragraphs and compare playback speeds before generating a long recording.

|  |  |
| --- | --- |
| Model | Kokoro Mandarin Chinese |
| 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 Mandarin Chinese in Muse Code

- Use Kokoro Mandarin Chinese to narrate the Mandarin onboarding guide in this repository. Remove Markdown syntax from the spoken script, split it into short paragraphs, and save one recording per section.
- Use Kokoro Mandarin Chinese to generate a sample from the first paragraph of our Mandarin tutorial at speed 1.0 and 0.9. Save both recordings with the exact script for a listening comparison.
- Use Kokoro Mandarin Chinese to create draft narration for the Mandarin help pages in this project. Generate one complete answer per recording and list English names or acronyms for pronunciation review.
- Use Kokoro Mandarin Chinese to narrate our latest release notes in Mandarin. Prepare a concise spoken script from the changelog, divide it by topic, and generate at speed 1.0.
- Use Kokoro Mandarin Chinese to make a listening version of the project's Mandarin introduction. Keep production notes out of the spoken text and generate short passages at speed 0.95.

## How to set up Kokoro Mandarin Chinese in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 Mandarin Chinese**: 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/mandarin-chinese",
    "input": {
      "prompt": "每一个伟大的旅程，都始于勇敢迈出的第一步。加油，你可以做到！",
      "voice": "zf_xiaobei"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds Kokoro Mandarin Chinese on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Kokoro Mandarin Chinese tools and prices

- [Kokoro TTS (Mandarin Chinese)](https://spiral.ai/tools/fal/fal-ai/kokoro/mandarin-chinese) (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 Mandarin Chinese in Muse Code?

Create Mandarin narration from project documentation, tutorial scripts, and help content. Have the agent prepare short spoken passages and generate samples for pronunciation and pacing review.

### Mandarin lesson narration

Turn a lesson script into spoken explanations. Generate one short passage first and compare normal and slower readings.

### Narrated articles

Make a listening version of a Mandarin article. Divide it into paragraphs and review pacing before assembling the recording.

### Product tutorial voiceovers

Narrate a Mandarin walkthrough one section at a time. Review product names and English terms before pairing the audio with screen recordings.

### Daily spoken briefings

Convert a checked Mandarin summary into a spoken briefing. Keep each topic in a separate passage so revisions stay manageable.

### Customer education audio

Create spoken explanations of common product questions in Mandarin. Use complete answers and review any names or acronyms.

### Listening practice

Generate Mandarin passages about everyday situations, with normal and slower readings for comparison. Have a fluent speaker review pronunciation before using them as teaching material.

### Voiceover script drafts

Audition Mandarin narration before recording or editing a video. Compare alternative wording and pacing using the same passage.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Kokoro Mandarin Chinese in other agents

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

## More Muse Code guides

- [Kokoro Japanese](https://spiral.ai/integrations/muse-code/kokoro-japanese)
- [Kokoro TTS Spanish](https://spiral.ai/integrations/muse-code/kokoro-tts-spanish)
- [Kokoro Italian](https://spiral.ai/integrations/muse-code/kokoro-italian)
- [Kotoba STT](https://spiral.ai/integrations/muse-code/kotoba-stt)
- [Kokoro Hindi](https://spiral.ai/integrations/muse-code/kokoro-hindi)
- [Lyria 3](https://spiral.ai/integrations/muse-code/lyria-3)

## Questions about Kokoro Mandarin Chinese in Muse Code

**Can Muse Code use Kokoro Mandarin Chinese?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run Kokoro Mandarin Chinese like any built-in tool.

**How much does Kokoro Mandarin Chinese cost in Muse Code?**

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 Muse Code plan is separate.

**Do I need a fal account to use Kokoro Mandarin Chinese in Muse Code?**

No. Spiral runs Kokoro Mandarin Chinese 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 Mandarin Chinese in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Kokoro Mandarin Chinese runs?**

Kokoro Mandarin Chinese runs in the background. Muse Code starts the run, checks on it and gives you the audio when it's ready.

**What should I use Kokoro Mandarin Chinese for?**

Use it to turn Mandarin scripts into narrated lessons, explainers, article readings, or spoken summaries. Prepare the wording first, then generate and review the speech.

**How long should each passage be?**

The maker recommends roughly 100–200 tokens per utterance for most voices. Start with short paragraphs rather than treating that range as a Chinese-character allowance.

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

The maker flags rushing on utterances above about 400 tokens. Split the script into shorter passages and compare a slower reading before generating the rest.

**How should I adjust the speaking pace?**

Lower speed values lengthen predicted speech durations; higher values shorten them. Compare the same passage at normal pace and a slightly slower pace so you can judge intelligibility.

**Can I mix English words into a Mandarin script?**

Test mixed-language passages carefully: the upstream Chinese processor calls interleaved English brittle. Review names and acronyms, and consider Chinese wording where it preserves the meaning.

