# Bytedance Seed Speech Text to Speech

Generate speech, music and audio with Bytedance Seed Speech Text to Speech from fal through one Spiral API key. It runs in the background and returns audio. Pay as you go, with no subscription.

- Provider: fal
- Category: Audio
- Runs: In the background
- Returns: audio
- Tool id: `fal` / `fal-ai/bytedance/seed-speech/tts/v2`
- Page: https://spiral.ai/tools/fal/fal-ai/bytedance/seed-speech/tts/v2

## Pricing

Each item in `text` adds $0.039.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 255 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `text` (required) | text |  | — | The text to synthesize into speech. |
| `voice` | one of | 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` | one of | mp3, opus | mp3 | Output audio format. 'mp3' returns MP3 audio; 'opus' returns Opus audio in an Ogg container. |
| `sample_rate` | one of | 8000, 16000, 22050, 24000, 32000, 44100, 48000 | 24000 | Sample rate of the output audio in Hz. |
| `speed` | number | 0.5 to 2 | 1 | Speech speed. 1.0 is normal speed, 0.5 is half speed, 2.0 is double speed. |
| `volume` | number | 0.5 to 2 | 1 | Volume. 1.0 is normal volume, 0.5 is half, 2.0 is double. |
| `pitch` | number (whole) | -12 to 12 | 0 | Voice pitch shift in semitones. 0 is normal pitch, -12 lowers by one octave, 12 raises by one octave. |
| `language` | one of | zh, en, ja, es-mx, id, pt-br, ko, it, de, fr | — | Force the text to be read as a single language, disabling automatic language detection. Leave unset for automatic detection (including seamless Chinese/English mixing on bilingual voices). Codes: zh (Chinese), en (English), ja (Japanese), es-mx (Mexican Spanish), id (Indonesian), pt-br (Brazilian Portuguese), ko (Korean), it (Italian), de (German), fr (French). |
| `voice_instruction` | text |  | — | Optional natural-language instruction that steers the delivery (tone, emotion, pace, volume), e.g. 'Speak in a cheerful tone' or 'Could you speak a bit slower?'. It is not spoken aloud and does not affect billing. |

## Example

```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."
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fbytedance%2Fseed-speech%2Ftts%2Fv2

## Common questions

### Bytedance Seed Speech Text to Speech

**How much does Bytedance Seed Speech Text to Speech cost?**

Each item in `text` adds $0.039. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Bytedance Seed Speech Text to Speech through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/bytedance/seed-speech/tts/v2"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Bytedance Seed Speech Text to Speech?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Bytedance Seed Speech Text to Speech?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

