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

Windsurf · Audio

How to Use Kotoba STT in Windsurf

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 Windsurf

Copy an example into Windsurf, 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 STTWindsurf
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 Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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: Windsurf 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 Windsurf 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 Windsurf?

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 Windsurf

Can Windsurf use Kotoba STT?

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

How much does Kotoba STT cost in Windsurf?

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

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

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 Windsurf?

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

Does Windsurf wait while Kotoba STT runs?

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

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

Paste this into Windsurf:

Set up Windsurf

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