Ключи 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, до 20 000 символов |
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 используют потоковый 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. Создание документов и экспорт файлов не требуют кредитов. Создание документов учитывается в ежедневном лимите документов вашего плана.
Подробнее: Что тратит кредиты.