Agent skill

Telnyx Stt Python

by majiayu000 in majiayu000/claude-skill-registry

Transcribe audio to text via the OpenAI-compatible transcription endpoint.

MITAuto-check passedMedia & Creative

Install Telnyx Stt Python

skills CLI
$ npx skills add majiayu000/claude-skill-registry --skill telnyx-stt-python -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install majiayu000/claude-skill-registry telnyx-stt-python --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/majiayu000/claude-skill-registry.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api/telnyx-stt-python .claude/skills/telnyx-stt-python && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
telnyx-stt-python
GitHub stars
666
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
344 words
Files
2
Skills in repo
1,273
Repo updated
First seen
Licence
MIT

At a glance

Transcribe audio to text via the OpenAI-compatible transcription endpoint.

  • Tasks that involve Transcription
  • SKILL.md covers Installation, Setup, Error Handling and Core Tasks, plus 2 more sections
  • Calls pip; reaches api.telnyx.com; needs TELNYX_API_KEY
  • Tasks that involve Speech recognition and synthesis

What it does

Telnyx Stt Python is an agent skill from majiayu000/claude-skill-registry. Transcribe audio to text via the OpenAI-compatible transcription endpoint. Supports multiple models, languages, and keyword biasing. Also lists available speech-to-text providers and service types.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `metadata.json`).

It sits in Media & Creative, covering Transcription and Speech recognition and synthesis. It works with Python and OpenAI. The repository describes itself as: Searchable Claude Code skills catalog with source-linked guides and generated registry artifacts. The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription
  • Tasks that involve Speech recognition and synthesis

Example prompts

  • “/telnyx-stt-python”

Requirements

  • Python 3
  • A credential in TELNYX_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 2d14a69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.telnyx.com

    Also links to:

    • platform.openai.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TELNYX_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Telnyx Stt Python loads about 1.4k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 344 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 2d14a69, republished under its MIT licence (© majiayu000). 344 words, ~1,394 tokens.

Download SKILL.mdSave it as .claude/skills/telnyx-stt-python/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
telnyx-stt-python
description
Transcribe audio to text via the OpenAI-compatible transcription endpoint. Supports multiple models, languages, and keyword biasing. Also lists available speech-to-text providers and service types.
metadata.author
telnyx
metadata.product
stt
metadata.language
python

Telnyx Speech-to-Text - Python

Installation

bash
pip install telnyx

Setup

python
import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),
)

All examples below assume client is already initialized as shown above.

Error Handling

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

python
import telnyx

try:
    response = client.ai.audio.transcribe(
        model="openai/whisper-large-v3-turbo",
        url="https://example.com/audio.mp3",
    )
except telnyx.APIConnectionError:
    print("Network error — check connectivity and retry")
except telnyx.RateLimitError:
    import time
    time.sleep(1)
except telnyx.APIStatusError as e:
    print(f"API error {e.status_code}: {e.message}")

Common error codes: 401 invalid API key, 403 insufficient permissions, 404 resource not found, 422 validation error, 429 rate limited.

Core Tasks

Transcribe speech to text

Transcribe an audio file to text. This endpoint is consistent with the OpenAI Transcription API and may be used with the OpenAI JS or Python SDK.

POST /ai/audio/transcriptions

ParameterTypeRequiredDescription
urlstring (URL)YesURL of the audio file to transcribe.
modelstringNoModel ID (e.g., openai/whisper-large-v3-turbo, distil-whisper/distil-large-v2).
languagestringNoLanguage code (e.g., en, es, fr).
promptstringNoOptional prompt to guide transcription style.
response_formatenumNojson, text, srt, verbose_json, vtt. Default: json.
temperaturenumberNoSampling temperature (0-1). Default: 0.
keywordsarray[string]NoKeyword biasing — improve accuracy for domain-specific terms.
python
# Basic transcription
response = client.ai.audio.transcribe(
    url="https://example.com/audio.mp3",
)
print(response.text)

# With specific model and language
response = client.ai.audio.transcribe(
    url="https://example.com/audio.mp3",
    model="openai/whisper-large-v3-turbo",
    language="es",
)
print(response.text)

# With keyword biasing for domain-specific terms
response = client.ai.audio.transcribe(
    url="https://example.com/audio.mp3",
    keywords=["Telnyx", "API", "WebRTC", "SIP"],
)
print(response.text)

# Verbose JSON with segments
response = client.ai.audio.transcribe(
    url="https://example.com/audio.mp3",
    response_format="verbose_json",
)
for segment in response.segments:
    print(f"[{segment.start:.1f}s - {segment.end:.1f}s] {segment.text}")

Primary response fields:

  • response.text — Full transcription text
  • response.duration — Audio duration in seconds
  • response.segments — Array of segment objects (with start, end, text) when using verbose_json format
List available STT providers

Retrieve a list of available speech-to-text providers and their service types.

GET /ai/audio/transcriptions/providers

python
response = client.ai.audio.list_providers()
for provider in response.providers:
    print(f"{provider['name']} — {provider['service_type']}")

# Filter by provider name
response = client.ai.audio.list_providers(provider="telnyx")
for provider in response.providers:
    print(f"{provider['name']} — {provider['service_type']}")

# Filter by service type
response = client.ai.audio.list_providers(service_type="transcription")
for provider in response.providers:
    print(f"{provider['name']} — {provider['service_type']}")

Primary response fields:

  • response.providers — Array of provider objects with name and service_type

CLI Usage

The Telnyx Agent CLI provides composite commands for STT:

bash
# Transcribe audio
telnyx-agent stt --audio-url https://example.com/audio.mp3 --json

# With specific model and language
telnyx-agent stt --audio-url https://example.com/audio.mp3 --model openai/whisper-large-v3-turbo --language es --json

# List available providers
telnyx-agent stt-providers --json

# Filter by provider or service type
telnyx-agent stt-providers --provider telnyx --service-type transcription --json

Important Notes

  • Audio URL: The audio file must be publicly accessible via a URL. Supported formats include mp3, mp4, mpeg, mpga, m4a, wav, and webm.
  • OpenAI compatibility: The transcription endpoint is OpenAI-compatible — you can use the OpenAI Python or JS SDK by setting the base URL to https://api.telnyx.com/v2/ai/openai.
  • Keyword biasing: Use keywords to improve transcription accuracy for domain-specific terms, product names, or acronyms that generic models may mishear.
  • Models: Available models include openai/whisper-large-v3-turbo (fast, accurate) and distil-whisper/distil-large-v2 (lightweight). Check stt-providers for the full list.
  • Languages: Use ISO 639-1 codes (en, es, fr, de, ja, etc.). Omit to auto-detect.
  • Response formats: Use verbose_json to get timestamps and segments. Use srt or vtt for subtitle files.

© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/api/telnyx-stt-python of majiayu000/claude-skill-registry.

  • SKILL.md
  • metadata.json

Open the folder on GitHubat commit 2d14a69

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Telnyx Stt Python next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Telnyx Stt Python compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Telnyx Stt Python this skillmajiayu000/claude-skill-registry6661 repos~1.4kAutomated safety check: PassMIT
Whisper Speech RecognitionOrchestra-Research/AI-Research-SKILLs13k8 repos~1.9kAutomated safety check: NotesMIT
Claude Real VideoHUANGCHIHHUNGLeo/claude-real-video2.2k—~639Automated safety check: PassMIT
9Router Speech-to-Textdecolua/9router30k—~745Automated safety check: PassMIT
Claude Real Video For AgentsHUANGCHIHHUNGLeo/claude-real-video2.2k—~2kAutomated safety check: NotesMIT
Video To NotesKIRVO-REPORTING/video-to-notes105—~1.5kAutomated safety check: PassMIT

Similar skills

  • Whisper Speech Recognition

    Orchestra-Research/AI-Research-SKILLs

    Transcribes audio with OpenAI's Whisper: 99 languages, translation to English, language detection, six model sizes and word-level timestamps, from Python or the CLI.

    13k GitHub starsUsed in 8 repos~1.9k tokens
    AI & LLM EngineeringAuto-check: notes
  • Claude Real Video

    HUANGCHIHHUNGLeo/claude-real-video

    Watch a video for the user. An agent skill from HUANGCHIHHUNGLeo/claude-real-video.

    2.2k GitHub stars~639 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    30k GitHub stars~745 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Claude Real Video For Agents

    HUANGCHIHHUNGLeo/claude-real-video

    Install and use crv (claude-real-video) — a tool that lets any AI agent watch videos by extracting scene-aware keyframes, deduplicating them, and transcribing audio.

    2.2k GitHub stars~2k tokensUpdated 7 days ago
    Media & CreativeAuto-check: notes
  • Video To Notes

    KIRVO-REPORTING/video-to-notes

    Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants.

    105 GitHub stars~1.5k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Openai Whisper API

    openclaw/openclaw

    OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1.

    392k GitHub starsUsed in 2 repos~518 tokens
    Media & CreativeAuto-check passed

More from majiayu000/claude-skill-registry

All 1,273 skills in this repo
  • Deep Research

    majiayu000/claude-skill-registry

    Multi-source deep research using firecrawl and exa MCPs. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 6 repos~1.1k tokens
    Auto-check passed
  • Exa Search

    majiayu000/claude-skill-registry

    Neural search via Exa MCP for web, code, and company research.

    666 GitHub starsUsed in 5 repos~856 tokens
    Auto-check passed
  • Fal AI Media

    majiayu000/claude-skill-registry

    Unified media generation via fal.ai MCP — image, video, and audio.

    666 GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed
  • Pyzotero

    majiayu000/claude-skill-registry

    Interact with Zotero reference management libraries using the pyzotero Python client.

    666 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check: notes
  • Bgpt Paper Search

    majiayu000/claude-skill-registry

    Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server.

    666 GitHub starsUsed in 4 repos~619 tokens
    Auto-check: notes
  • Bio Alignment Pairwise

    majiayu000/claude-skill-registry

    Perform pairwise sequence alignment using Biopython Bio.Align.PairwiseAligner.

    666 GitHub starsUsed in 4 repos~1.7k tokens
    Auto-check passed

Works with

Questions about Telnyx Stt Python

What does Telnyx Stt Python do?

Transcribe audio to text via the OpenAI-compatible transcription endpoint. Telnyx Stt Python is an agent skill from majiayu000/claude-skill-registry. Transcribe audio to text via the OpenAI-compatible transcription endpoint.

When should I use Telnyx Stt Python?

Telnyx Stt Python fits situations like: tasks that involve Transcription; tasks that involve Speech recognition and synthesis.

How do I install Telnyx Stt Python in Claude Code?

Run `npx skills add majiayu000/claude-skill-registry --skill telnyx-stt-python -a claude-code`. Or copy the skill folder (skills/api/telnyx-stt-python in majiayu000/claude-skill-registry) into .claude/skills/telnyx-stt-python in your project. Claude Code loads it when a task matches its description.

How do I install Telnyx Stt Python in Codex?

Run `npx skills add majiayu000/claude-skill-registry --skill telnyx-stt-python -a codex`. Or copy the skill folder (skills/api/telnyx-stt-python in majiayu000/claude-skill-registry) into .agents/skills/telnyx-stt-python in your project. Codex loads it when a task matches its description.

Can I use Telnyx Stt Python in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add majiayu000/claude-skill-registry --skill telnyx-stt-python -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/telnyx-stt-python, .gemini/skills/telnyx-stt-python, .github/skills/telnyx-stt-python and .opencode/skills/telnyx-stt-python in your project.

What does Telnyx Stt Python need to run?

Going by SKILL.md and its folder, Telnyx Stt Python needs the command-line tools its instructions call (pip) and credentials named TELNYX_API_KEY. Our summary lists: Python 3; A credential in TELNYX_API_KEY.

Does Telnyx Stt Python access the network?

SKILL.md names 2 domains. In commands or code: api.telnyx.com; the agent is likely to contact it when it follows the instructions. As links in the text: platform.openai.com. This is read from the text; nothing was executed.

Is Telnyx Stt Python safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Telnyx Stt Python use?

Telnyx Stt Python is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Telnyx Stt Python use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Telnyx Stt Python?

Skills that share tags, products or a category with Telnyx Stt Python: Whisper Speech Recognition (Orchestra-Research/AI-Research-SKILLs, 13k stars), Claude Real Video (HUANGCHIHHUNGLeo/claude-real-video, 2.2k stars), 9Router Speech-to-Text (decolua/9router, 30k stars) and Claude Real Video For Agents (HUANGCHIHHUNGLeo/claude-real-video, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Telnyx Stt Python?

majiayu000 (a GitHub user) maintains it in majiayu000/claude-skill-registry, which has 666 GitHub stars. The repository holds 1,273 skills in this directory. The repository was last updated on October 7, 2026.

Source: majiayu000/claude-skill-registry on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.