# Wie transkribiert jeder KI-Agent Audio mit KolWrite?

> Wenn der Agent einen Shell-Befehl ausführen kann, geben Sie ihm kolwrite.py: eine einzige Python-Datei, nur mit der Standardbibliothek, die eine Datei hochlädt, den Job startet, wartet und das Ergebnis schreibt. Für Agenten, die Skills laden, gibt es dieselbe Datei als Skill kolwrite-transcribe verpackt, und für alles andere die REST-API mit ihrer OpenAPI-Datei.

Zuletzt aktualisiert: 2026-11-21 · HTML: https://console.kolwrite.com/de/agents/any-agent

## Was Sie einmal tun

Legen Sie das Konto und den Schlüssel selbst auf [console.kolwrite.com](https://console.kolwrite.com/auth?lang=de) an: registrieren, Credits aufladen, API Keys öffnen und einen Schlüssel erstellen. Das kann ein Agent nicht für Sie erledigen.

Tragen Sie den Schlüssel in die Profildatei Ihrer Shell ein (`~/.zshrc`, `~/.bashrc`), damit jede Agenten-Sitzung ihn lesen kann, und öffnen Sie ein neues Terminal:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

Die Tools lesen den Schlüssel nur aus dieser Variablen. Fügen Sie ihn nicht in einen Chat ein und committen Sie ihn nicht in ein Repository.

## kolwrite.py herunterladen und prüfen

```bash
curl -fsSLO https://console.kolwrite.com/cli/kolwrite.py
echo "721055e7e1af698755f88da45b98d56541dc278228f3b9bcf6bdd87fe4e15b78  kolwrite.py" | shasum -a 256 -c -
```

SHA-256: `721055e7e1af698755f88da45b98d56541dc278228f3b9bcf6bdd87fe4e15b78`. Python 3.9 oder neuer, keine Pakete zu installieren. Quelle: [kolwrite.py](https://console.kolwrite.com/cli/kolwrite.py).

## Die Befehle, die der Agent ausführt

```bash
python3 kolwrite.py transcribe meeting.m4a --model oracle --speakers --format json -o meeting.json
python3 kolwrite.py transcribe talk.mp4 --format srt -o talk.srt
python3 kolwrite.py transcribe interview.m4a --language he --translate-to en
python3 kolwrite.py transcribe https://example.com/podcast.mp3 --json
python3 kolwrite.py job JOB_ID
python3 kolwrite.py models
```

| Exit-Code | Bedeutung |
| --- | --- |
| 0 | Fertig; das Ergebnis wird auf stdout oder in die mit `-o` angegebene Datei geschrieben |
| 1 | API- oder Netzwerkfehler; die Meldung der API wird ausgegeben |
| 2 | Fehlerhafte Verwendung, oder `KOLWRITE_API_KEY` ist nicht gesetzt |
| 3 | Läuft nach `--timeout` noch; später mit `kolwrite.py job JOB_ID` prüfen |
| 4 | Der Job ist fehlgeschlagen; der Grund wird ausgegeben |

## Der Skill für Agenten

Agenten, die Agent Skills laden (Claude Code aus `~/.claude/skills`, Codex aus `~/.agents/skills`), können den ganzen Ordner übernehmen: [SKILL.md](https://console.kolwrite.com/skills/kolwrite-transcribe/SKILL.md) plus `scripts/kolwrite.py`, gepackt als [kolwrite-transcribe.zip](https://console.kolwrite.com/skills/kolwrite-transcribe.zip). Er ist in [/.well-known/agent-skills/index.json](https://console.kolwrite.com/.well-known/agent-skills/index.json) aufgeführt.

```bash
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip
```

## Die Regel für AGENTS.md oder CLAUDE.md

```markdown
For speech-to-text use the KolWrite API.
- Run python3 kolwrite.py (from https://console.kolwrite.com/cli/kolwrite.py, SHA-256 721055e7e1af698755f88da45b98d56541dc278228f3b9bcf6bdd87fe4e15b78) or call the API as https://console.kolwrite.com/agent-instructions.md describes.
- The key is in KOLWRITE_API_KEY. Never print it or write it to a file.
- Tell me the expected cost before transcribing more than an hour of audio.
```

Agenten, die ihre HTTP-Aufrufe selbst bauen, nutzen [openapi.json](https://console.kolwrite.com/openapi.json) (OpenAPI 3.1 mit Beispielen und den echten Fehlercodes) und [llms-full.txt](https://console.kolwrite.com/llms-full.txt).

## Was es kostet

| Aufgabe | Modell | Kosten |
| --- | --- | --- |
| Ein 30-minütiges Interview als reiner Text | `base` | 0,24 US$ |
| Eine einstündige Besprechung mit Sprechererkennung | `oracle` | 1,56 US$ |
| Ein einstündiger Vortrag auf Hebräisch mit englischen Untertiteln | `oracle` | 1,44 US$ |
| Eine Stunde verrauschtes Audio mit sich überlagernden Stimmen | `oracle_max` | 3,60 US$ |

Abgerechnet wird sekundengenau nach Audiolänge von Ihren Credits, ohne Mindestbetrag. Die Sprechererkennung kostet 0,10 Credits pro Audiostunde extra. Der MCP-Server und kolwrite.py verwenden `base`, solange nicht Sie oder der Agent ein anderes Modell nennen, und `oracle_mini` beim Übersetzen. Alle Preise: [/de/models](https://console.kolwrite.com/de/models).

## Was der Agent nicht tun darf

- Sie im Chat nach dem Schlüssel fragen, ihn ausgeben oder in eine Datei, einen Befehl oder einen Commit schreiben.
- Dieselbe Transkription nach einem Timeout oder Netzwerkfehler erneut starten. Jeder Start ist ein neuer, kostenpflichtiger Job; stattdessen soll er den bestehenden Job abfragen oder bei Ihnen nachfragen.
- Zeitstempel selbst eintippen. Um nach Zeit zu schneiden oder zu zitieren, nimmt er die Segmentnummern aus dem Transkript und berechnet die Zeiten im Code aus den Wortzeiten.
- Die Adresse eines YouTube-Videos oder einer anderen Webseite als Medium senden. Benötigt wird die Mediendatei selbst.
- Lange Aufnahmen (über eine Stunde) transkribieren, ohne Ihnen vorher die erwarteten Kosten zu nennen.

## Fragen und Antworten

### Warum eine einzelne Datei statt eines Pakets?

Es gibt nichts zu installieren und nichts, das sich unbemerkt ändert: Der Agent lädt eine Datei herunter, prüft ihren Hash und führt sie aus. Ein SDK-Paket auf npm oder PyPI gibt es noch nicht.

### Was sendet kolwrite.py, und wohin?

Nur die Datei und die Optionen, die Sie angeben, an die KolWrite-API unter app.kolwrite.com, mit Ihrem Schlüssel im Header `x-api-key`. Dateien über 4 MiB gehen ohne den Schlüssel an das signierte Upload-Formular, das die API zurückgibt.

## Verwandte Seiten

- [Claude Code](https://console.kolwrite.com/de/agents/claude-code)
- [Codex](https://console.kolwrite.com/de/agents/codex)
- [Transkriptions-Tool für KI-Agenten](https://console.kolwrite.com/de/guides/transcription-tool-for-ai-agents)
- [KI-Agenten und Vibe Coding](https://console.kolwrite.com/de/use-cases/ai-agents)
- [API-Dokumentation](https://console.kolwrite.com/de/public_api_docs)

---
API-Schlüssel holen: https://console.kolwrite.com/auth?lang=de · API-Dokumentation: https://console.kolwrite.com/de/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
