Klucze API i MCP
Twórz klucze API, wywołuj każdy publiczny endpoint REST oraz łącz się z oficjalnym serwerem MCP Speechdash.
Użyj Ustawienia → API, aby utworzyć klucze i połączyć asystentów. Ten sam klucz sh_live_… uprawnia do publicznego API REST oraz oficjalnego serwera MCP. Połączenia pod Ustawienia → Połączenia to inna funkcja: łączą trzecie-stronne serwery MCP z wbudowaną czatową komunikacją.
Tworzenie klucza
- Otwórz Ustawienia → API.
- Kliknij Nowy klucz, nadaj mu nazwę (na przykład
Serwer produkcji) i natychmiast skopiuj go. Przechowywane jest tylko prefiks; pełen sekret wyświetla się tylko raz. - Wyślij
Authorization: Bearer sh_live_…z serwera. Nigdy nie umieszczaj klucza w przeglądarce, aplikacji mobilnej ani publicznym repozytorium.
Możesz utrzymać do 10 aktywnych kluczy. Odwołaj klucz, który wyciekł, z tej samej strony.
Weryfikuj klucz za pomocą GET /v1/me (email, plan i portfel). Adres bazowy: https://api.speechdash.com/v1.
Endpointy REST
Każda publiczna ścieżka HTTP:
| Metoda | Ścieżka | Cel |
|---|---|---|
GET | /health | Zdrowie usługi (bez klucza API; nie pod /v1) |
GET | /v1/openapi.json | Kontrakt OpenAPI 3.1 |
GET | /v1/me | Konto, plan i portfel |
GET | /v1/documents | Lista dokumentów biblioteki, w tym zakończonych transkrypcji |
POST | /v1/documents | Utwórz dokument tekstowy (source=api) |
GET | /v1/documents/{document_id} | Odczytaj dokument i jego tekst |
PUT | /v1/documents/{document_id} | Zaktualizuj tytuł, tekst, język, is_archived, lub visibility |
DELETE | /v1/documents/{document_id} | Usuń dokument |
POST | /v1/documents/{document_id}/translate | Nowa wersja przetłumaczona (te same punkty jak eksport MP3) |
GET | /v1/documents/{document_id}/export | Pobierz pdf, docx, txt, csv, srt, lub vtt |
POST | /v1/audio/speech | Synthesaizuj do 5000 znaków (JSON + audio) |
POST | /v1/audio/stream | Strumieniowanie WAV, do 20 000 znaków |
POST | /v1/audio/stream/with-timestamps | SSE z audio na podstawie zdań i znaków |
GET | /v1/voices | Katalog głosów |
GET | /v1/voices/{voice_id} | Jedno ustawienie głosu (na przykład F1) |
API nie uruchamia zadań transkrypcji audio lub wideo. Zakończone zadania pojawiają się jako dokumenty biblioteki (source=transcription). Strony interaktywne do testowania: Konto, Dokumenty, Audio, Głosy.
Narzędzia MCP
Oficjalny serwer pod adresem https://mcp.speechdash.com/mcp udostępnia jedno narzędzie na bibliotekę lub akcję mowy. ChatGPT używa OAuth. Cursor i Claude Desktop używają Streamable HTTP z Twoim osobistym kluczem API.
| Narzędzie MCP | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
Źródło: speechdash://openapi (żywy JSON OpenAPI).
Strumieniowanie mowy (POST /v1/audio/stream i POST /v1/audio/stream/with-timestamps) nie ma narzędzia MCP. Użyj REST dla tych ścieżek oraz dla /health.
Konfiguracja: Serwer MCP oraz Hub Asystentów.
Punkty
Syntetyzacja mowy (REST i MCP) zużywa 0.5 punktu na każde rozpoczęte 30 sekund generowanego audio. Tłumaczenie zużywa taką samą stawkę jak eksport MP3. Tworzenie dokumentów i eksportu plików nie zużywa punktów. Tworzenie dokumentów liczy się w dziennej limicie dokumentów Twojego planu.
Zobacz Co zużywa punkty.