[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Seed Speech TTS 2.0](https://spiral.ai/integrations/codex/seed-speech-tts-2-0)

# How to Use Seed Speech TTS 2.0 in Codex

Seed Speech TTS 2.0 turns written scripts into expressive narration for explainers, assistant replies, and support messages. Compared with Seed Speech TTS 1.0, it adds natural-language direction for delivery.

|  |  |
| --- | --- |
| Model | Seed Speech TTS 2.0 |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.039. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seed Speech TTS 2.0 in Codex

- Read the onboarding documentation in this project and draft a 90-word spoken introduction. Use Seed Speech TTS 2.0 to narrate it with a patient, conversational delivery, and save the script beside the audio.
- Find the password-reset instructions in this project's interface copy. Create a short narration with Seed Speech TTS 2.0, using a calm, reassuring delivery and preserving the actual recovery steps.
- Use the latest changelog entry to write a 75-word release announcement. Narrate it with Seed Speech TTS 2.0 in a pleased but restrained tone, and keep unsupported claims out of the script.
- Review this project's Chinese and English welcome copy. Make one short mixed-language greeting with Seed Speech TTS 2.0 using a voice that supports mixing Chinese and English and automatic language handling.
- Take the first paragraph of this project's tutorial and generate two readings with Seed Speech TTS 2.0: one neutral and one encouraging. Keep the spoken words identical and save both for review.

## How to set up Seed Speech TTS 2.0 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 Seed Speech TTS 2.0**: 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/bytedance/seed-speech/tts/v2",
    "input": {
      "text": "Hello, this is a test of ByteDance TTS 2.0 speech synthesis."
    }
  }'
```

Then paste one of the prompts above: Codex finds Seed Speech TTS 2.0 on Spiral, shows the price and runs it.

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

## Seed Speech TTS 2.0 tools and prices

- [Bytedance Seed Speech Text to Speech](https://spiral.ai/tools/fal/fal-ai/bytedance/seed-speech/tts/v2) (fal): $0.039 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| voice | vivi_mixed_en_zh_ja_es_id, mindy_en_es_id_pt_zh, stokie_en, dacey_en, tim_en, kian_en_zh, cedric_en_zh, sophie_en_zh, jean_en_zh, magnus_en_zh, mabel_en_zh, nadia_en_zh, opal_en_zh, pearl_en_zh, quentin_en_zh, vienna_mixed_en_zh, alina_mixed_en_zh, corinne_mixed_en_zh, esther_mixed_en_zh, freya_mixed_en_zh, gigi_mixed_en_zh, holly_mixed_en_zh, lyla_mixed_en_zh, daisy_mixed_en_zh, tracy_es_zh, jess_ja_es_id_pt_en_zh, pinky_es_ko_mixed_en_zh, sweety_ja_es, sandy_es_mixed_en_zh, sven_de, minimi_ja, usseau_fr, felipe_es, han_id, martins_pt, enzo_it, shane_ko, bonnie_zh, felix_zh, celeste_zh, monkey_king_zh | stokie_en | Voice to use for synthesis. The preset name encodes the voice and its supported language codes. 'mixed_en_zh' means the voice can seamlessly blend English and Chinese; separate codes (e.g. 'en_zh') mean the voice supports each language independently. |
| output_format | mp3, opus | mp3 | Output audio format. 'mp3' returns MP3 audio; 'opus' returns Opus audio in an Ogg container. |
| sample_rate | 8000, 16000, 22050, 24000, 32000, 44100, 48000 | 24000 | Sample rate of the output audio in Hz. |
| speed | 0.5 to 2 | 1 | Speech speed. 1.0 is normal speed, 0.5 is half speed, 2.0 is double speed. |
| volume | 0.5 to 2 | 1 | Volume. 1.0 is normal volume, 0.5 is half, 2.0 is double. |
| pitch | -12 to 12 | 0 | Voice pitch shift in semitones. 0 is normal pitch, -12 lowers by one octave, 12 raises by one octave. |

## What can you do with Seed Speech TTS 2.0 in Codex?

Turn project documentation and interface copy into spoken walkthroughs and audio drafts. Use Seed Speech TTS 2.0 to audition delivery while reviewing the script alongside the source text.

### Product walkthrough narration

Turn an approved walkthrough script into spoken instructions. Request a patient delivery for steps listeners need to follow.

### Customer support responses

Read approved support replies in a calm, reassuring tone, especially when explaining a delay or a recovery step.

### Spoken assistant answers

Give a text assistant a spoken response with delivery suited to the answer, such as restrained for a correction or cheerful for good news.

### Chinese and English announcements

Narrate announcements that switch between Chinese and English using a voice that supports mixing both languages.

### Daily audio briefings

Convert a short, checked daily summary into narration with a consistent voice and delivery instruction.

### Character dialogue drafts

Generate separate readings of scripted lines with different emotional directions to audition how a scene sounds.

### Training lesson narration

Read lesson scripts in short passages with an unhurried delivery. Review the readings before adding them to a course.

## Overview

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

## Seed Speech TTS 2.0 in other agents

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

## More Codex guides

- [Seed Audio 1.0](https://spiral.ai/integrations/codex/seed-audio-1-0)
- [Sonilo V1.1 Text to Music](https://spiral.ai/integrations/codex/sonilo-v1-1-text-to-music)
- [Scribe v3](https://spiral.ai/integrations/codex/scribe-v3)
- [Sonilo v1.1 Text to Sound Effects](https://spiral.ai/integrations/codex/sonilo-v1-1-text-to-sound-effects)
- [Scribe v2](https://spiral.ai/integrations/codex/scribe-v2)
- [Sonilo v1.1 Video to Music](https://spiral.ai/integrations/codex/sonilo-v1-1-video-to-music)

## Questions about Seed Speech TTS 2.0 in Codex

**Can Codex use Seed Speech TTS 2.0?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Seed Speech TTS 2.0 like any built-in tool.

**How much does Seed Speech TTS 2.0 cost in Codex?**

Each item in `text` adds $0.039. 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 Seed Speech TTS 2.0 in Codex?**

No. Spiral runs Seed Speech TTS 2.0 on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Seed Speech TTS 2.0 in Codex?**

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

**Does Codex wait while Seed Speech TTS 2.0 runs?**

Seed Speech TTS 2.0 runs in the background. Codex starts the run, checks on it and gives you the audio when it's ready.

**What is Seed Speech TTS 2.0 useful for?**

Use it to narrate explainers, speak assistant replies, or produce customer support messages. Its delivery instructions let you request a tone that fits the script.

**How should I describe the delivery?**

Keep the spoken script separate from directions such as “calm and reassuring” or “cheerful, with an unhurried pace.” Put those directions in the delivery instruction so they are not read aloud.

**Can Seed Speech TTS 2.0 read Chinese and English in one script?**

Yes, with a voice that supports mixing Chinese and English. Use automatic language handling for the mixed script rather than forcing one language.

**Why might a multilingual script fail?**

Multilingual support depends on the selected voice. Check that the voice supports the language in your script; a language mismatch can cause generation to fail.

**How should I handle a long narration?**

Split it into shorter passages if it exceeds the accepted text length. Keeping the same voice and delivery instruction across passages is a practical way to organize the narration.

