[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [Kotoba STT](https://spiral.ai/integrations/factory-droid/kotoba-stt)

# How to Use Kotoba STT in Factory Droid

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, no API key |

## Prompts to try with Kotoba STT in Factory Droid

- Use Kotoba STT to transcribe the 90-second Japanese demo recording in this project with word timings. Create a draft SRT file and preserve the raw transcript beside it.
- Use Kotoba STT to transcribe the 60-second English feature walkthrough in this project. Use product names from the README as spelling guidance, then compare the transcript with the documented behavior.
- Use Kotoba STT on the 90-second Japanese interview excerpt in this repository with speaker separation and word timings. Save a transcript organized by speaker and time.
- Use Kotoba STT to transcribe the 45-second Korean bug-report recording in this project. Draft a reproduction checklist from the transcript and mark details the recording does not establish.
- Use Kotoba STT to transcribe the 60-second Japanese narration in this project with personal names written in katakana. Save the transcript for the localization reviewer.

## How to set up Kotoba STT in Factory Droid

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

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid 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 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: Factory Droid finds Kotoba STT on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## 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 Factory Droid?

Turn recorded demos, interviews, and voice notes into text your coding agent can use alongside project files. Ask the agent to turn timed transcripts into caption drafts or compare spoken product terminology with the repository.

### 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 Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## 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)
- [dots](https://spiral.ai/integrations/dots/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 Factory Droid guides

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

## Questions about Kotoba STT in Factory Droid

**Can Factory Droid use Kotoba STT?**

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

**How much does Kotoba STT cost in Factory Droid?**

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 Factory Droid plan is separate.

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

No. Spiral runs Kotoba STT on its own fal account. You sign in to Spiral once and never paste a key.

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

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

**Does Factory Droid wait while Kotoba STT runs?**

Kotoba STT runs in the background. Factory Droid 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.

