Skip to main content
skill CX Codex

openrouter-stt — Claude Code skill: what it does, how to install

openrouter-stt converts audio recordings into text using OpenRouter's speech-to-text API across models like Whisper and Chirp.

no license 319 installs ★ 327 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-code
Open on GitHub

What openrouter-stt does

This skill instructs coding assistants how to query POST /api/v1/audio/transcriptions. It turns audio files into base64 payloads inside a standard JSON body and handles network requests using curl, TypeScript fetch, or Python requests. The API delivers the transcribed text along with billing details.

This endpoint is completely incompatible with OpenAI SDK conventions: sending multipart/form-data with a file attachment fails immediately. You must export an OPENROUTER_API_KEY environment variable before sending any transcription request.

The input_audio.format value must mirror the underlying audio encoding, whether wav, mp3, flac, m4a, ogg, webm, or aac. Mismatched containers cause mis-decoded transcripts or 400 validation failures.

What it helps with

  • convert recorded meetings and audio files into plain text
  • generate captions from extracted video audio tracks
  • query OpenRouter models supporting transcription modality
  • pass vocabulary prompts to specific transcription providers

Example prompts for the agent

  • Transcribe meeting.wav using google/chirp-3 via OpenRouter
  • Extract text from interview.mp3 using openai/whisper-large-v3
  • List all available transcription models on OpenRouter

How to install openrouter-stt

1Skills CLI (Vercel)

npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-code

2Manually: put the files in place

~/.claude/skills/openrouter-stt/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/openrouter-stt/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about openrouter-stt

How to install openrouter-stt in Claude Code?

Run npx skills add OpenRouterTeam/skills --skill openrouter-stt -a claude-code in your terminal.

What does openrouter-stt do?

It guides AI agents on preparing base64 payloads and making valid HTTP requests to OpenRouter's speech-to-text service.

Can I use the official OpenAI SDK with this endpoint?

No, OpenRouter accepts JSON payloads with embedded base64 audio rather than the multipart form expected by OpenAI client libraries.

Similar skills

All skills for AI and ML →

From the same set16

The whole set →
openrouter-generations openrouter-generations is a Claude Code skill for inspecting OpenRouter requests by generation ID. It shows token costs, latency, provider routing, and saved prompts. CX Codex +1 383installs openrouter-agent-migration openrouter-agent-migration walks you through switching agent imports from @openrouter/sdk to the @openrouter/agent package. CX Codex +1 383installs openrouter-oauth openrouter-oauth adds Sign In with OpenRouter to browser apps via OAuth PKCE without a backend, SDK, or client credentials. CX Codex +1 362installs create-agent-tui create-agent-tui is a Claude Code skill that generates a TypeScript agent with terminal UI, tools, and sessions for building an agent from scratch or adding a terminal interface. CX Codex +1 358installs openrouter-analytics-schema Fetches live OpenRouter analytics schema details, including metrics, dimensions, and filter rules. Useful when constructing usage or cost queries. CX Codex +1 355installs openrouter-analytics-query openrouter-analytics-query — a skill for building and running queries against the OpenRouter analytics API. Use it to pull metrics on model usage, group results by dimensions, and filter by time, model, or other parameters. CX Codex +1 355installs openrouter-tts openrouter-tts synthesizes speech audio from text using OpenRouter's speech API. Generates voiceovers, audiobook snippets, and audio files right from your prompt. CX Codex +1 327installs create-headless-agent create-headless-agent scaffolds headless TypeScript agents using Bun and @openrouter/agent. Builds CLI utilities, API servers, queue workers, and data pipelines without a terminal UI. CX Codex +1 320installs

Project sponsors

Companies that keep this analytics open