Publiczne API Speechdash jest dostępne

Publiczne API Speechdash działa pod adresem api.speechdash.com/v1. Jeśli budujesz produkty, w których trzeba słuchać tekstu, możesz tworzyć dokumenty i generować mowę bez otwierania interfejsu w przeglądarce.

Ten wpis podsumowuje, co jest dostępne, jak działa rozliczanie i jak wysłać pierwsze żądanie w kilka minut.

Co API umożliwia dziś

REST API odzwierciedla stos słuchania znany z aplikacji:

• Tworzenie i zarządzanie dokumentami w bibliotece Speechdash użytkownika (import tekstu z tytułem i językiem)
• Generowanie mowy z presetami Narrator, Pytający i Ekspert w wielu językach
• Listowanie, odczyt, aktualizacja i usuwanie dokumentów przez przewidywalne endpointy JSON

Dokumenty utworzone przez API pojawiają się w bibliotece na speechdash.com. Twoi użytkownicy mogą dalej słuchać w aplikacji, edytować tekst, eksportować audio lub wrócić na innym urządzeniu.

Synteza mowy korzysta z tych samych głosów w chmurze co odtwarzanie w aplikacji. Zużycie pobierane jest z portfela kredytów konta, według tych samych zasad co słuchanie w chmurze w produkcie.

Dla kogo

Zespoły sięgają po API, gdy słuchanie ma żyć w innym produkcie:

• LMS i platformy nauki z czytaniem na głos zadań lub artykułów
• Warstwy dostępności w narzędziach SaaS
• Narzędzia wewnętrzne importujące treści partiami do weryfikacji „uszem”
• Prototypy potrzebujące mówionej podglądu przed pełnym interfejsem

Jeśli użytkownicy mają już konta Speechdash, zachowują jeden portfel i jedną bibliotekę. API to dodatkowe wejście, nie osobny produkt.

Uwierzytelnianie i dokumentacja

Każde konto tworzy klucze API w Ustawienia → API na speechdash.com/settings/api. Klucz pokazywany jest raz; po stronie serwera zapisywany jest tylko prefiks.

W każdym żądaniu wysyłaj Authorization: Bearer sh_live_…. Nieprawidłowy lub unieważniony klucz zwraca 401.

Dokumentacja dla programistów jest w centrum pomocy:

• Przegląd API (uwierzytelnianie, limity, rozliczanie, idempotencja)
• Kontrakt OpenAPI na żywo: api.speechdash.com/v1/openapi.json

Strona produktu Publiczne API streszcza ofertę dla osób nietechnicznych w zespole.

Rozliczanie w skrócie

Żądania mowy blokują szacunek, potem rozliczają zmierzony czas. Przy ponowieniach możesz wysłać Idempotency-Key przy tworzeniu dokumentu i syntezie, by uniknąć podwójnej opłaty po problemie sieciowym.

Limity częstotliwości obowiązują na konto (nie na klucz). Odpowiedzi zawierają standardowe nagłówki i Retry-After, gdy warto odczekać.

Pierwsze żądanie w pięć minut

1. Zaloguj się na speechdash.com i otwórz Ustawienia → API
2. Utwórz klucz i skopiuj go od razu
3. Przeczytaj przegląd API
4. Wyślij krótki tekst metodą POST na /v1/documents albo wywołaj /v1/audio/speech z presetem głosu i językiem

Zacznij od dwóch zdań, zanim przetworzysz cały rozdział. Przegląd wymienia dokładne pola i przykładowe odpowiedzi.

Co dalej

Będziemy rozwijać API wraz z produktem. Jeśli integrujesz już teraz, dołącz na Discord po wczesny feedback albo otwórz centrum pomocy, gdy coś w kontrakcie jest niejasne.

Dziękujemy, że budujesz z Speechdash. Czekamy na to, co opublikujesz.

Powiązane materiały

• Strona funkcji Publiczne API
• Pierwsze kroki ze Speechdash
• Odtwarzanie w chmurze
• Formaty importu
• Co zużywa kredyty