AI agenti: nechte přepisy dělat svého asistenta
Používáte AI asistenta jako Claude Code, OpenAI Codex, ChatGPT s nástroji
nebo jiného agenta? Můžete mu dát přístup ke svému účtu Transkripce a přepisy pak
zadávat jednou větou — asistent spustí přepis, počká na výsledek a přinese vám
hotový text. Nahrání audia umí přes REST API, pokud tento typ přístupu podporuje.
Vy jen platíte kredity jako dosud.
Tato stránka vysvětluje, jak to zapnout, bez technických znalostí.
Jak to funguje (ve třech větách)
1. Ve svém profilu si vytvoříte API klíč — je to „klíč od vašeho účtu pro
asistenta": dlouhý kód začínající transcription_sk_.
2. Klíč jednorázově vložíte do svého AI asistenta (návod níže).
3. Od té chvíle asistentovi stačí říct např. *„Přepiš soubor schuze.mp3 na
Transkripci a dej mi hotový text"*. Pokud má vedle MCP přístup i k REST API,
soubor nahraje sám; jinak nejprve použije soubor, který nahrajete v aplikaci.
Krok 1: Vytvořte si API klíč
1. Přihlaste se a otevřete Profil → API klíče pro AI agenty.
2. Zadejte název (např. „můj Claude") a nechte zaškrtnutá oprávnění
čtení i zápis.
3. Volitelně nastavte rozpočet — např. „30 kreditů/den". Je to pojistka:
asistent pak nemůže za den utratit víc, i kdyby se „zacyklil". Prázdné pole
= bez limitu (utrácí jen do výše vašich kreditů).
4. Klikněte na Vytvořit klíč a hned si klíč zkopírujte — z bezpečnostních
důvodů se zobrazí jen jednou.
> Klíč je jako heslo. Nikomu ho neposílejte, nevkládejte do veřejných
> dokumentů. Kdykoli ho můžete v profilu revokovat — asistent tím okamžitě
> ztratí přístup.
Krok 2: Připojte asistenta
Claude Code (Anthropic)
V terminálu spusťte jeden příkaz (klíč vložte místo VAS_KLIC):
claude mcp add --transport http transcription https://transkripce.i-dotaznik.cz/api/v1/transcription/mcp --header "Authorization: Bearer VAS_KLIC"
Hotovo — Claude Code od teď „umí Transkripci" jako svůj nástroj (technologie
MCP). Ověřte větou: *„Vypiš mé přepisy na Transkripci."*
OpenAI Codex a další asistenti s podporou MCP
Přidejte do konfigurace asistenta MCP server (u Codexu soubor config.toml,
sekce mcp_servers):
- adresa:
https://transkripce.i-dotaznik.cz/api/v1/transcription/mcp - typ připojení: streamable HTTP
- hlavička:
Authorization: Bearer VAS_KLIC
Asistent bez podpory MCP?
Stačí mu říct:
> „Použij REST API na https://transkripce.i-dotaznik.cz/api/v1/transcription/
> (dokumentace: https://transkripce.i-dotaznik.cz/llms-full.txt), autentizuj se
> hlavičkou Authorization: Bearer VAS_KLIC."
Vše, co asistent potřebuje vědět, si přečte sám na uvedené adrese.
Krok 3: Zadávejte úkoly lidsky
Příklady pokynů, které fungují:
- *„Přes REST nahraj
rozhovor.mp3na Transkripci, spusť přepis a až bude hotový, ulož mi ho jako text."* - *„Kolik mám na Transkripci kreditů a na kolik vyjde přepis dvouhodinové nahrávky?"*
- *„Stáhni mi finální přepis a kontrolní report z mého posledního dokončeného přepisu."*
MCP server nabízí 10 nástrojů pro spuštění a sledování workflow, stažení přepisu
a kontrolního reportu, práci s kredity a přípravu platebního odkazu. Nahrání audia
není MCP nástroj: probíhá pouze přes REST POST /api/v1/transcription/audio-files.
Platby a bezpečnost
- Asistent utrácí jen vaše předplacené kredity (1 kredit = 1 započatá
minuta audia) — ke kartě ani platbám se nedostane.
- Když kredity nestačí, přepis se nespustí. Asistent vám ale umí rovnou
připravit platební odkaz na dobití (Stripe) — vy jen odkaz otevřete a
platbu potvrdíte. Sám zaplatit nemůže, ke kartě se nedostane.
- Rozpočet na klíči (kredity/den, kredity/měsíc) doporučujeme nastavit
vždy — je to horní pojistka proti nečekané útratě.
- Neúspěšné zpracování se neúčtuje (stejně jako při ručním použití).
- Podezření na zneužití klíče? V profilu ho revokujte a vytvořte nový.
Pro samotné AI agenty (strojově čitelné zdroje)
- Kompletní dokumentace:
https://transkripce.i-dotaznik.cz/llms-full.txt - REST API + OpenAPI:
https://transkripce.i-dotaznik.cz/api/v1/transcription/openapi.json - MCP server:
https://transkripce.i-dotaznik.cz/api/v1/transcription/mcp - Projektová discovery konvence (nejde o oficiální MCP standard):
https://transkripce.i-dotaznik.cz/.well-known/mcp.json - Tato nápověda v Markdown/textu:
/napoveda/raw/*.md,/napoveda/raw/*.txt