Veřejné API Speechdash je spuštěné

Veřejné API Speechdash běží na adrese api.speechdash.com/v1. Stavíte-li produkty, kde je potřeba poslouchat text, můžete vytvářet dokumenty a generovat řeč bez otevírání webového rozhraní.

Tento článek shrnuje, co je k dispozici, jak funguje účtování a jak během pár minut odeslat první požadavek.

Co API dnes umí

REST API kopíruje poslechový stack, který už znáte z aplikace:

• Vytvářet a spravovat dokumenty v knihovně Speechdash uživatele (import textu s názvem a jazykem)
• Generovat řeč s předvolbami Vypravěč, Tazatel a Expert v mnoha jazycích
• Vypisovat, číst, upravovat a mazat dokumenty přes předvídatelné JSON endpointy

Dokumenty vytvořené přes API se objeví v knihovně na speechdash.com. Uživatelé mohou dál poslouchat v aplikaci, upravovat text, exportovat audio nebo pokračovat na jiném zařízení.

Syntéza řeči používá stejné cloudové hlasy jako přehrávání v aplikaci. Spotřeba se odečítá z peněženky kreditů účtu podle stejných pravidel jako cloudový poslech v produktu.

Pro koho

Týmy sáhnou po API, když má poslech žít v jiném produktu:

• LMS a studijní platformy s hlasitým čtením úkolů nebo článků
• Vrstvy přístupnosti v SaaS nástrojích
• Interní nástroje, které hromadně importují obsah ke kontrole uchem
• Prototypy, které potřebují mluvený náhled před plným rozhraním

Mají-li vaši uživatelé účty Speechdash, drží jednu peněženku a jednu knihovnu. API je další vstup, ne samostatný produkt.

Autentizace a dokumentace

Každý účet vytváří API klíče v Nastavení → API na speechdash.com/settings/api. Klíč se zobrazí jednou; na serveru zůstane jen prefix.

U každého požadavku posílejte Authorization: Bearer sh_live_…. Neplatný nebo zrušený klíč vrátí 401.

Dokumentace pro vývojáře je v centru nápovědy:

• Přehled API (autentizace, limity, účtování, idempotence)
• Živá smlouva OpenAPI na api.speechdash.com/v1/openapi.json

Produktová stránka Veřejné API shrne nabídku pro netechnické členy týmu.

Účtování stručně

Požadavky na řeč blokují odhad a poté vypořádají naměřenou délku. Při opakování můžete poslat Idempotency-Key při vytvoření dokumentu a syntéze, aby síťová chyba neúčtovala dvakrát.

Limity rychlosti platí na účet (ne na klíč). Odpovědi obsahují standardní hlavičky a Retry-After, když je vhodné počkat.

První požadavek za pět minut

1. Přihlaste se na speechdash.com a otevřete Nastavení → API
2. Vytvořte klíč a hned ho zkopírujte
3. Přečtěte si přehled API
4. Odešlete krátký text metodou POST na /v1/documents, nebo volejte /v1/audio/speech s hlasovou předvolbou a jazykem

Začněte dvěma větami, než zpracujete celou kapitolu. Přehled uvádí přesná pole a ukázkové odpovědi.

Co bude dál

API budeme rozšiřovat podle potřeb produktu. Integrujete-li teď, připojte se na Discord pro brzkou zpětnou vazbu, nebo otevřete centrum nápovědy, pokud něco ve smlouvě není jasné.

Děkujeme, že stavíte se Speechdashem. Těšíme se, co vydáte.

Související průvodci

• Stránka funkce Veřejné API
• Začínáme se Speechdashem
• Cloudové přehrávání
• Formáty importu
• Co spotřebovává kredity