[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Kotoba STT](https://spiral.ai/integrations/dots/kotoba-stt)

# How to Use Kotoba STT in dots

Kotoba STT turns recorded speech into text, with a focus on Japanese and East Asian languages. Use it for clips up to two minutes when you need a transcript, word timings, or speaker labels.

|  |  |
| --- | --- |
| Model | Kotoba STT |
| Available through | fal |
| Category | Audio |
| Price | Up to $0.005382 per run at the default inputs for 60 seconds of input. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Kotoba STT in dots

- Every morning, use Kotoba STT to transcribe new Japanese voice messages of two minutes or less. Preserve each transcript and list any explicit requests separately.
- Each afternoon, use Kotoba STT to transcribe new English product-demo recordings of two minutes or less with word timings. Prepare caption drafts for review.
- Every weekday, use Kotoba STT to transcribe new Japanese interview excerpts of two minutes or less with speaker labels and timings. Keep each excerpt separate and identify passages worth reviewing.
- Each evening, use Kotoba STT to transcribe new Korean customer comments of two minutes or less. Put recurring topics in a separate digest with the supporting transcript passages.
- Every Friday, use Kotoba STT to transcribe new Japanese introduction recordings of two minutes or less with personal names written in katakana. Prepare the transcripts for a name-spelling review.

## How to set up Kotoba STT in dots

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

### Use the Spiral skill

1. **Send dots 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### 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 Kotoba STT**: 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": "kotoba-technologies/kotoba-stt/v1/speech-to-text",
    "input": {
      "audio_url": "<audio_url>",
      "language": "ja"
    }
  }'
```

Then paste one of the prompts above: dots finds Kotoba STT on Spiral, shows the price and runs it.

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

## Kotoba STT tools and prices

- [Kotoba STT · Speech to Text](https://spiral.ai/tools/fal/kotoba-technologies/kotoba-stt/v1/speech-to-text) (fal): $0.0000897 per second.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| with_timestamps |  | false | Return `words` with start and end times for each word. |
| diarization |  | false | Attribute words to speakers (`speaker_id` on each word; models with speaker tokens only). Word times are null unless `with_timestamps` is also set. |
| keywords |  | — | Up to 1000 terms of at most 64 characters, such as names or product words, whose spelling the transcript should prefer. |
| kana |  | false | Write personal and place names in katakana (Japanese). |

## What can you do with Kotoba STT in dots?

Build a recurring review of short recorded messages and interview excerpts. Have the agent preserve each transcript before producing summaries, caption drafts, or lists of follow-up questions.

### Japanese interview excerpts

Transcribe an interview excerpt of up to two minutes with speaker labels and timings, then have your agent arrange the transcript for editorial review.

### Caption drafts for short videos

Transcribe a video's spoken audio in clips of up to two minutes with word timings. Have your agent turn the timed text into caption drafts for review.

### Product demo transcripts

Turn a short narrated demo into text, supplying product names as spelling guidance. Use the transcript as the starting point for written instructions.

### Customer research excerpts

Transcribe recorded customer comments in clips of up to two minutes. Keep the transcript beside any themes or observations your agent extracts from it.

### Japanese name review

Request katakana personal names in a short Japanese recording to prepare a phonetic transcript for a reviewer.

### Recorded voice notes

Transcribe short Japanese, English, Korean, or Chinese voice notes. Have your agent turn the text into a checklist while preserving the original transcript.

## Overview

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

## Kotoba STT in other agents

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

## More dots guides

- [Kokoro TTS Spanish](https://spiral.ai/integrations/dots/kokoro-tts-spanish)
- [Lyria 3](https://spiral.ai/integrations/dots/lyria-3)
- [Kokoro Mandarin Chinese](https://spiral.ai/integrations/dots/kokoro-mandarin-chinese)
- [Lyria 3 Pro](https://spiral.ai/integrations/dots/lyria-3-pro)
- [Kokoro Japanese](https://spiral.ai/integrations/dots/kokoro-japanese)
- [Lyria 3.5](https://spiral.ai/integrations/dots/lyria-3-5)

## Questions about Kotoba STT in dots

**Can dots use Kotoba STT?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Kotoba STT like any built-in tool.

**How much does Kotoba STT cost in dots?**

Up to $0.005382 per run at the default inputs for 60 seconds of input. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use Kotoba STT in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs Kotoba STT on its own fal account.

**How long does it take to set up Kotoba STT in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Kotoba STT runs?**

Kotoba STT runs in the background. dots starts the run, checks on it and gives you the json when it's ready.

**What is Kotoba STT best suited for?**

Recorded speech, especially Japanese and East Asian audio. Word timings and speaker labels make it useful for preparing caption drafts and reviewing interview excerpts.

**How long can a recording be?**

Keep each clip within two minutes. For a longer recording, prepare shorter excerpts before transcription.

**Which spoken languages are documented?**

Kotoba documents Japanese, English, Korean, and Chinese for file transcription.

**How can I guide the spelling of names and technical terms?**

Supply the relevant spellings as keywords, such as a speaker's name or a product name. Treat them as spelling guidance and check the resulting transcript against the recording.

**Can I get speaker labels with timings?**

Yes. Request speaker separation and word timings together when you need to see who spoke and where their words occur in the recording.

