A Speechdash nyilvános API elérhetővé vált

A Speechdash nyilvános API mostantól elérhető a api.speechdash.com/v1 címen. Ha olyan termékeket fejlesztesz, ahol az embereknek szöveget kell meghallgatniuk, dokumentumokat hozhatsz létre és beszédet generálhatsz anélkül, hogy megnyitnád a böngészős felületet.

Ez a bejegyzés bemutatja, mit adtunk ki, hogyan működik a számlázás, és hogyan küldheted el az első kérésed néhány perc alatt.

Mit tud a mai API?

A REST API visszatükrözi a hallgatói veremrészeket, amelyeket már ismerhetsz az alkalmazásból:

• Dokumentumok létrehozása és kezelése a felhasználó Speechdash könyvtárában (szövegimport címmel és nyelvvel)
• Beszéd generálása Narrátor, Kérdező és Szakértő hangbeállításokkal sok nyelven
• Dokumentumok listázása, olvasása, frissítése és törlése kiszámítható JSON végpontokon keresztül

Az API-n keresztül létrehozott dokumentumok megjelennek a könyvtárban a speechdash.com oldalon. A felhasználóid továbbra is hallgathatnak az alkalmazásban, szerkeszthetik a szöveget, exportálhatják a hangot, vagy folytathatják egy másik eszközről.

A beszédszintézis ugyanazokat a felhőhangokat használja, mint az alkalmazásbeli lejátszás. A felhasználás az account hitelwalteredből vonódik le, ugyanazokkal a szabályokkal, mint a felhőhallgatás a termékben.

Kinek szól?

Csapatok akkor fordulnak az API-hez, amikor a hallgatás egy másik terméken belül kellene működjön:

• LMS és tanulási platformok, amelyek felolvasást szeretnének azAssignmentokra vagy cikkekre
• Hozzáférhetőségi rétegek SaaS eszközökben
• Belső eszközök, amelyek tömegesen importálnak tartalmat füllel történő áttekintéshez
• Prototípusok, amelyeknek hangos előnézetre van szükségük egy teljes UI kiadása előtt

Ha a felhasználóidnak már van Speechdash fiókja, ők megtartják egy pénztárcát és egy dokumentumkönyvtárat. Az API egy extra bejárati ajtó, nem egy külön termék.

Hitelesítés és dokumentáció

Minden fiók API kulcsokat hoz létre a Beállítások → API alatt az alkalmazásban. A kulcsokat egyszer mutatják meg; csak egy előtagot tárol a szerver.

Küldj Authorization: Bearer sh_live_… fejlécet minden kérésnél. Érvénytelen vagy visszavont kulcsok 401 válaszokat kapnak.

A fejlesztői dokumentáció a Segítségközpontban található:

• API áttekintés (hitelesítés, korlátok, számlázás, idempotencia)
• Élő OpenAPI szerződés a api.speechdash.com/v1/openapi.json címen

A marketing jellegű funkcióoldal Publikus API összefoglalja a történetet a csapatod nem fejlesztő tagjai számára.

Számlázás egy pillantásra

A beszédkérések tartják a becslést, majd elszámolódnak a mért időtartam alapján. Újrapróbálkozások küldhetnek egy Idempotency-Key fejlécet a dokumentum létrehozásához és a beszédhez, így egy hálózati hiba nem számolódik el kétszer.

Korlátozások per fiókra vonatkoznak (nem per kulcsra). A válaszok tartalmazzák a standard korlátozási fejléceket és a Retry-After értéket, amikor le kell lassítanod.

Első kérés öt perc alatt

1. jelentkezz be a speechdash.com oldalra, és nyisd meg a Beállítások → API részt
2. Hozz létre egy kulcsot, és másold le azonnal
3. Olvasd el az API áttekintést
4. POST egy rövid szöveget a /v1/documents végpontra, vagy hívd meg a /v1/audio/speech endpointot egy hangbeállítással és nyelvvel

Kezdj egy két mondatos mintával, mielőtt egy teljes fejezetet streamelsz. Az áttekintő dokumentum felsorolja a pontos mezőket és a példa válaszokat.

Mi következik?

Az API-t bővítjük, ahogy a terméki igények nőnek. Ha ma integrálsz, csatlakozz a Discord csatornához a korai visszajelzésért, vagy nyisd meg a Segítségközpontot, ha valami nem világos a szerződésben.

Köszönjük, hogy a Speechdash-szel építesz. Izgatottak vagyunk, hogy mit hozol létre.

Kapcsolódó útmutatók

• Publikus API funkcióoldal
• Speechdash kezdő lépések
• Felhőlejátszás
• Import formátumok
• Mi használ fel krediteket