Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Audio

How to Use Kotoba STT in Claude Code

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.

Prompts to try with Kotoba STT in Claude Code

Copy an example into Claude Code, or ask in your own words.

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.

Kotoba STTClaude Code
Try asking
  • 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 Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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.

    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.

    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: Claude Code finds Kotoba STT on Spiral, shows the price and runs it.

Kotoba STT providers and prices

Spiral runs Kotoba STT through fal. Open a card for today's price, with every fee included.

falAudio
Kotoba STT · Speech to Text
kotoba-technologies/kotoba-stt/v1/speech-to-text

Settings you can ask for

Kotoba STT works from your audio URL. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Languageja, en, ko, zh, es, zh-hk, zh-tw, or auto

Language spoken in the audio.

With timestampson or offoff

Return words with start and end times for each word.

Diarizationon or offoff

Attribute words to speakers (speaker_id on each word; models with speaker tokens only). Word times are null unless with_timestamps is also set.

Kanaon or offoff

Write personal and place names in katakana (Japanese).

Every API field of Kotoba STT · Speech to Text is on its tool page: open its card above.

What can you do with Kotoba STT in Claude Code?

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.

Questions about Kotoba STT in Claude Code

Can Claude Code use Kotoba STT?

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

How much does Kotoba STT cost in Claude Code?

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 Claude Code plan is separate.

Do I need a fal account to use Kotoba STT in Claude Code?

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 Claude Code?

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

Does Claude Code wait while Kotoba STT runs?

Kotoba STT runs in the background. Claude Code 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.

Get started

Start using Kotoba STT in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options