[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Qwen3-TTS 1.7B](https://spiral.ai/integrations/opencode/qwen3-tts-1-7b)

# How to Use Qwen3-TTS 1.7B in opencode

Qwen3-TTS 1.7B turns scripts into multilingual narration with instructions for tone, pace, and emotion. Unlike Qwen3-TTS 0.6B CustomVoice, it supports instruction-based control of delivery.

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

## Prompts to try with Qwen3-TTS 1.7B in opencode

- Read the project's onboarding documentation and write a 100-word introduction for new users. Use Qwen3-TTS 1.7B to narrate it in English with a patient tone and measured pace.
- Find the password-reset instructions in the project and turn them into a short spoken explanation. Use Qwen3-TTS 1.7B with reassuring English delivery.
- Use the project's release notes to draft a 90-word spoken update. Generate the narration with Qwen3-TTS 1.7B in English, sounding pleased but restrained.
- Take the first tutorial script in the project and generate two readings with Qwen3-TTS 1.7B: one slow and instructional, one conversational. Keep the words identical.
- Find the reviewed Japanese onboarding copy in the project and generate a short narration with Qwen3-TTS 1.7B. Use clear, measured delivery and retain the approved wording.

## How to set up Qwen3-TTS 1.7B 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 Qwen3-TTS 1.7B**: 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/qwen-3-tts/text-to-speech/1.7b",
    "input": {
      "text": "I am solving the equation: x = [-b ± √(b²-4ac)] / 2a? Nobody can — it'\''s a disaster (◍•͈⌔•͈◍), very sad!"
    }
  }'
```

Then paste one of the prompts above: opencode finds Qwen3-TTS 1.7B on Spiral, shows the price and runs it.

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

## Qwen3-TTS 1.7B tools and prices

- [Qwen 3 TTS 1.7B · Text to Speech](https://spiral.ai/tools/fal/fal-ai/qwen-3-tts/text-to-speech/1.7b) (fal): $0.117 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 |
| --- | --- | --- | --- |
| prompt |  | — | Optional prompt to guide the style of the generated speech. This prompt will be ignored if a speaker embedding is provided. |
| voice | Vivian, Serena, Uncle_Fu, Dylan, Eric, Ryan, Aiden, Ono_Anna, Sohee | — | The voice to be used for speech synthesis, will be ignored if a speaker embedding is provided. Check out the **[documentation](https://github.com/QwenLM/Qwen3-TTS/tree/main?tab=readme-ov-file#custom-voice-generate)** for each voice's details and which language they primarily support. |
| language | Auto, English, Chinese, Spanish, French, German, Italian, Japanese, Korean, Portuguese, Russian | Auto | The language of the voice. |
| speaker_voice_embedding_file_url |  | — | URL to a speaker embedding file in safetensors format, from `fal-ai/qwen-3-tts/clone-voice` endpoint. If provided, the TTS model will use the cloned voice for synthesis instead of the predefined voices. |
| reference_text |  | — | Optional reference text that was used when creating the speaker embedding. Providing this can improve synthesis quality when using a cloned voice. |
| top_k | 0 to … | 50 | Top-k sampling parameter. |

## What can you do with Qwen3-TTS 1.7B in opencode?

Create spoken walkthroughs and help clips from the project's documentation. Use delivery instructions to compare how the same script sounds at different paces and emotional intensities.

### Product tutorial narration

Turn a walkthrough script into measured speech, with delivery instructions suited to explaining each action.

### Language listening exercises

Create spoken practice passages in supported languages. Start with a speaker whose native language matches the lesson.

### Daily audio briefings

Read a prepared news or operations summary with a neutral tone and a consistent speaking pace.

### Story narration

Give short stories a specified emotional delivery, then compare restrained and more expressive readings.

### Multilingual explainer narration

Generate separate readings of reviewed translations in supported languages for educational or product videos.

### Spoken help content

Create audio readings of common support answers with a patient tone and an unhurried pace.

### Narration direction tests

Read the same script with different tone, pace, and emotion instructions before choosing a delivery for production.

## Overview

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

## Qwen3-TTS 1.7B in other agents

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

## More opencode guides

- [Qwen3-TTS 0.6B Clone Voice](https://spiral.ai/integrations/opencode/qwen3-tts-0-6b-clone-voice)
- [Qwen3-TTS 1.7B Voice Design](https://spiral.ai/integrations/opencode/qwen3-tts-1-7b-voice-design)
- [Qwen3 TTS 1.7B Clone Voice](https://spiral.ai/integrations/opencode/qwen3-tts-1-7b-clone-voice)
- [SAM Audio](https://spiral.ai/integrations/opencode/sam-audio)
- [Qwen3 TTS 0.6B](https://spiral.ai/integrations/opencode/qwen3-tts-0-6b)
- [SAM Audio Visual Separation](https://spiral.ai/integrations/opencode/sam-audio-visual-separation)

## Questions about Qwen3-TTS 1.7B in opencode

**Can opencode use Qwen3-TTS 1.7B?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Qwen3-TTS 1.7B like any built-in tool.

**How much does Qwen3-TTS 1.7B cost in opencode?**

Each item in `text` adds $0.117. 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 Qwen3-TTS 1.7B in opencode?**

No. Spiral runs Qwen3-TTS 1.7B on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Qwen3-TTS 1.7B in opencode?**

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

**Does opencode wait while Qwen3-TTS 1.7B runs?**

Qwen3-TTS 1.7B runs in the background. opencode starts the run, checks on it and gives you the audio when it's ready.

**What is Qwen3-TTS 1.7B useful for?**

It is a useful choice for narrated tutorials, spoken briefings, and lessons that need a specified tone or pace. You can direct the delivery with instructions such as calm, measured, or excited.

**Which languages does Qwen3-TTS support?**

It supports Chinese, English, Japanese, Korean, German, French, Russian, Portuguese, Spanish, and Italian. Qwen recommends using a speaker's native language for the best quality.

**How should I describe the delivery?**

Specify tone, pace, and emotion in concrete terms. For example, try: Speak slowly with a reassuring tone and restrained emotion.

**Can Qwen3-TTS generate long narration?**

Qwen evaluated speech exceeding 10 minutes, but that result does not establish a maximum duration per request. Review long recordings for repeated words, omissions, and changes in delivery.

**What audio sample rate does Qwen3-TTS use?**

The native decoder output is 24 kHz. The 12Hz name refers to its speech tokenizer rather than the audio sample rate.

