Ключі API та MCP
Створюйте ключі API, викликайте будь-який публічний REST-ендпоїнт і підключайте офіційний сервер MCP Speechdash.
Використовуйте Налаштування → API, щоб створити ключі та підключити асистентів. Тотожний ключ sh_live_… авторизує публічний REST-API та офіційний сервер MCP. Підключення під Налаштування → Підключення — це інша функція: вони приєднують третій-сторонні сервери MCP до чату в додатку.
Створення ключа
- Відкрийте Налаштування → API.
- Натисніть Новий ключ, назвіть його (наприклад,
Виробничий сервер) та відразу скопіюйте його. Зберігається лише префікс; повний секрет показується лише один раз. - Відправляйте
Authorization: Bearer sh_live_…з вашого сервера. Ніколи не розміщуйте ключ у браузері, мобільному додатку або публічному репозиторії.
Ви можете зберігати до 10 активних ключів. Відкликайте компрометований ключ на тому ж сторінці.
Перевірте ключ за допомогою GET /v1/me (електронна пошта, план та гаманець). Базовий URL: https://api.speechdash.com/v1.
REST-ендпоїнти
Будь-який публічний HTTP-маршрут:
| Метод | Шлях | Мета |
|---|---|---|
GET | /health | Стан сервісу (без ключа API; не під /v1) |
GET | /v1/openapi.json | Угода OpenAPI 3.1 |
GET | /v1/me | Обліковий запис, план та гаманець |
GET | /v1/documents | Список документів бібліотеки, включаючи завершені транскрипти |
POST | /v1/documents | Створення текстового документа (source=api) |
GET | /v1/documents/{document_id} | Читання документа та його тексту |
PUT | /v1/documents/{document_id} | Оновлення назви, тексту, мови, is_archived або visibility |
DELETE | /v1/documents/{document_id} | Видалення документа |
POST | /v1/documents/{document_id}/translate | Нова перекладена версія (такі ж кредити, як і експорт MP3) |
GET | /v1/documents/{document_id}/export | Завантаження pdf, docx, txt, csv, srt або vtt |
POST | /v1/audio/speech | Синтез до 5000 символів (JSON + аудіо) |
POST | /v1/audio/stream | Поток WAV, до 20000 символів |
POST | /v1/audio/stream/with-timestamps | SSE з аудіо за реченнями та позначками |
GET | /v1/voices | Каталог голосів |
GET | /v1/voices/{voice_id} | Один настрій голосу (наприклад F1) |
API не запускає завдання транскрипції аудіо чи відео. Завершені завдання з'являються як документи бібліотеки (source=transcription). Інтерактивні сторінки для тестування: Обліковий запис, Документи, Аудіо, Голоси.
Інструменти MCP
Офіційний сервер за адресою https://mcp.speechdash.com/mcp пропонує один інструмент на кожну дію бібліотеки чи мови. ChatGPT використовує OAuth. Cursor і Claude Desktop використовують Streamable HTTP з вашим особистим ключем API.
| Інструмент 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 |
Ресурс: speechdash://openapi (живий JSON OpenAPI).
Струминний синтез мови (POST /v1/audio/stream та POST /v1/audio/stream/with-timestamps) не має інструменту MCP. Використовуйте REST для цих маршрутів та для /health.
Налаштування: Сервер MCP та Хаб агентів.
Кредити
Синтез мови (REST та MCP) витрачає 0.5 кредитів на кожні 30 секунд генерованого аудіо. Переклад використовує таку ж ставку, як і експорт MP3. Створення документів та експорт файлів не витрачає кредитів. Створення документів враховується у щоденному обмеженні документів вашого плану.
Див. Що використовує кредити.