---
name: stenobird
description: Give AI agents ears for podcasts. Transcribe public audio URLs and return text that can be searched, summarized, quoted, and cited.
homepage: https://stenobird.com
docs: https://stenobird.com/docs.md
metadata: {"api_base":"https://stenobird.com"}
---

# Stenobird

Give your agent ears for podcasts.

Stenobird accepts a public audio URL and streams transcript text back through an API, skill, or browser preview. Use it when a human asks you to transcribe, summarize, quote, search, or analyze audio from a public URL.

## Quick start for agents

1. Install the Stenobird skill when your environment supports skills:

```bash
curl -fsSL https://stenobird.com/skills/stenobird-transcribe/install.sh | sh
```

2. Submit the exact public audio URL the human gave you.
3. Read streamed transcript events until `event: done`.
4. Use the transcript for the requested task: summary, quotes, claims, chapters, or analysis.
5. Include the original source URL in your answer.

## Tool invocation examples

```text
Codex: Use $stenobird-transcribe with this audio:
https://www.dwarkesh.com/p/jensen-huang

Claude Code / Hermes / OpenClaw:
/stenobird-transcribe https://www.dwarkesh.com/p/jensen-huang

Pi:
/skill:stenobird-transcribe https://www.dwarkesh.com/p/jensen-huang
```

## API contract

Create a transcript job:

```http
POST /v1/transcripts
Content-Type: application/json
Authorization: Bearer <api_key>

{"audio_url":"https://example.com/audio-url"}
```

Public requests stream a free 15 second preview. Add `Authorization: Bearer <api_key>` for full transcript streams.

The response includes `id`, `status_url`, `events_url`, `result_url`, `terminal`, and `result_ready`.

Stream events:

```http
GET /v1/transcripts/{id}/events
Accept: text/event-stream
Authorization: Bearer <api_key>
```

Important event types:

- `status`: progress only.
- `transcript`: append `data.text` to the transcript.
- `preview_locked`: public preview stopped; ask the human for an API key or send them to pricing.
- `done`: terminal event; fetch `result_url` when `result_ready` is true.
- `error`: stop and report `data.message`.

## Human handoff

If you need full transcripts, ask the human to get an API key at https://stenobird.com/pricing and set it as `STENOBIRD_API_KEY`. Full transcripts cost $0.01 per completed audio minute; failed, rejected, and canceled requests are not billed.

## Machine-readable resources

- Skill: https://stenobird.com/skill.md
- LLM index: https://stenobird.com/llms.txt
- Full LLM docs: https://stenobird.com/llms-full.txt
- API docs: https://stenobird.com/docs.md
- OpenAPI: https://stenobird.com/openapi.json