Automatizujte Transept pomocí API

Osobní API klíč si vytvoříte v sekci Nastavení → Vývojář. Je k dispozici v každém tarifu včetně verze Free – přístup není nijak omezen, využití limituje pouze váš zůstatek slov. Klíč pojmenujte, volitelně nastavte platnost a zkopírujte si tajný klíč (secret), jakmile se zobrazí: zobrazí se pouze jednou a později už jej nebude možné získat. Na stejné stránce můžete klíč kdykoli zneplatnit.

Požadavky se autentizují pomocí klíče v hlavičce Authorization: Bearer tsk_live_… – klíč patří výhradně do hlavičky, nikdy do URL.

Od API klíče k přeloženému výstupu vás dělí jen šest krátkých volání. Slova se odečítají pouze za samotné spuštění překladu; odhady jsou zdarma a při opakovaném volání se stejným Idempotency-Key získáte původní výsledek, místo aby se vám účtovalo dvakrát.

Stejná volání s podrobnějším komentářem najdete na transept.ai/developers. Průvodce lokalizačním API vás provede zbytkem: katalogy řetězců, e-mailovými šablonami, glosáři, týmy a schvalovacími procesy.

export KEY="tsk_live_…"                          # minted under Settings → Developer
BASE="https://app.transept.ai/api/public/v1"

# 1. Check the key: your account, its permissions, your word balance
curl -s $BASE/me -H "Authorization: Bearer $KEY"

# 2. Create a document; Transept creates one language version per target
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Welcome email", "content": "# Welcome…", "content_type": "markdown",
       "source_language": "en", "target_languages": ["de", "fr", "uk"]}'

# 3. Estimate: the word cost, free, with no side effects
curl -s -X POST $BASE/group-runs/estimate \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"document_id": "<master>", "template_id": "end_to_end", "target_languages": "all"}'

# 4. Run: the same body starts it
curl -s -X POST $BASE/group-runs \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-1" \
  -d '{"document_id": "<master>", "template_id": "end_to_end", "target_languages": "all"}'

# 5. Wait: poll for per-language progress (or get pushed an event; see below)
curl -s $BASE/group-runs/<group-run-id> -H "Authorization: Bearer $KEY"

# 6. Read each language back in the format you need (the table below lists them)
curl -s "$BASE/documents/<version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Dokument můžete vytvořit z prostého textu, HTML či markdownu, nebo nahrát soubor – podporovány jsou stejné formáty jako v aplikaci. Importovat lze také tabulku řetězců (.tstrings.json): strukturovaný formát pro texty rozhraní nebo herní řetězce, kde je každý řetězec jednotkou se stálým klíčem a vlastním kontextem – poznámkou o tom, o co jde, kde se text zobrazuje, jaký má limit znaků a co znamenají jeho zástupné symboly. Všechny tyto informace se dostanou k modelu, zástupné symboly jako {name} jsou chráněny proti smazání či přejmenování a množná čísla se rozbalí podle konkrétního jazyka (z jedné anglické formy se stanou dvě v němčině a čtyři v ukrajinštině). Veškeré překlady, které už soubor obsahuje, se importují v původní podobě, zdarma a okamžitě se jimi naplní překladová paměť.

Hromadné spuštění překládá do několika jazyků najednou. Zadejte název dokumentu, workflow nebo šablonu ke spuštění a cílové jazyky; Transept vytvoří chybějící jazykové verze a v každé z nich workflow spustí. Celý proces sledujete pod jedním ID – jeho dotazováním zjistíte postup u jednotlivých jazyků i to, zda se čeká na korekturu.

Při opakovaných spuštěních stačí znovu odeslat aktuální soubor tabulky řetězců a Transept sám rozpozná, co se změnilo: u nezměněných řetězců zůstanou zachovány překlady (včetně již hotových revizí) a běh se dotkne pouze nových nebo skutečně změněných jednotek – jde o API variantu funkce Spouštět pouze změny. Celý tento cyklus založený na klíčích, od prvního importu až po rozdílové běhy, popisuje návod Lokalizace katalogu řetězců přes API.

Místo dotazování si zaregistrujte URL a Transept odešle událost, kdykoliv běh skončí nebo selže, když je připravena korektura k nahlédnutí, když se dokončí zpracování nahrávání nebo když je připraven export. Každé doručení obsahuje hlavičku HMAC-SHA256 X-Transept-Signature: t=…,v1=…, aby váš příjemce mohl ověřit, že zpráva skutečně pochází od nás. Pokud koncový bod selhává, pokusy o doručení se opakují s postupným odkladem, než dojde k jeho deaktivaci.

# register once; every matching event is POSTed to your URL, signed
curl -s -X POST $BASE/webhooks \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/transept-events",
       "events": ["group_run.completed", "run.gate_ready", "run.failed"]}'
# → the endpoint, including its ONE-TIME secret; verify X-Transept-Signature with it

Workflow se může spustit i automaticky pomocí automatizace databáze v Notionu: nasměrujte webhook automatizace na URL spouštěče a Transept spustí workflow na stránce, kde došlo ke změně. Má to ale háček: webhook z Notionu nikdy nepřenáší samotný obsah stránky – pouze informuje o tom, která stránka akci vyvolala. Transept si tuto stránku načte přes vaše propojení s Notionem, takže musí být splněny dvě podmínky, jinak bude každý pokus o spuštění zamítnut s chybou přístupu a na kartě spouštěče se zobrazí poznámka „nepodařilo se načíst stránku z Notionu“:

• Propojte Notion v Transeptu – v nabídce Settings → Integrations. Jde o jednorázové propojení přes OAuth, které Transeptu umožní číst data vaším jménem.
• Nasdílejte zdrojovou databázi s integrací přímo v Notionu – otevřete databázi (nebo stránku), klikněte na nabídku •••, zvolte Connections a přidejte Transept. Samotné propojení Notionu v nastavení ještě neuděluje přístup ke konkrétní databázi; bez tohoto kroku sice spojení funguje, ale stránka zůstane nečitelná.
• Spouštějte akci změnou vlastnosti, ne jen úpravou obsahu. Automatizace v Notionu reagují na změny vlastností (a přidání stránky), takže samotná úprava těla stránky nemusí nic vyvolat. Spolehlivým řešením je sledování vlastnosti Status – jakmile ji přepnete (např. na „Ready to translate“), právě tato změna aktivuje spouštěč.

Kompletní seznam koncových bodů je k dispozici jako specifikace OpenAPI, kterou můžete importovat do n8n, Zapieru nebo generátoru kódu: prohlédněte si interaktivní dokumentaci nebo si stáhněte samotný JSON. Dáváte přednost praktickému průvodci? transept.ai/developers nabízí rychlý úvod s příklady k okamžitému použití a průvodce lokalizačním API podrobně rozebírá celý proces. U běhů spuštěných přes API se slova účtují úplně stejně jako v editoru přímo v aplikaci.

Ano – Transept nabízí koncový bod MCP, ke kterému se AI asistenti připojují: https://app.transept.ai/api/public/v1/mcp. Propojení využívá standardní OAuth: přidejte URL do Claude Code, Claude Desktop, Cursoru nebo jakéhokoli MCP klienta a v okně prohlížeče schvalte přístup – nemusíte nikam vkládat žádný klíč (v CI a headless prostředích lze stále použít API klíč v hlavičce Bearer). Asistent má poté k dispozici nástroje pro celý proces: import dokumentů, spouštění workflow napříč jazyky, správu glosářů a stylistických příruček, dotazování do překladové paměti i načítání výsledků. Vše hlídají dvě pojistky: každý nástroj respektuje oprávnění, která jste udělili, a u všeho, co by spotřebovávalo slova, asistent nejprve obdrží odhad počtu slov – asistent musí spuštění potvrdit výslovně, takže vám agent nikdy nic nenaúčtuje omylem. Hotové ukázky nastavení pro jednotlivé klienty najdete v aplikaci na stránce Integrations; kompletního průvodce od schvalovací obrazovky až po odpojení najdete v článku Připojení AI asistenta.