Chaves de API e MCP
Crie chaves de API, acesse todos os endpoints REST públicos e conecte o servidor MCP oficial do Speechdash.
Use Configurações → API para criar chaves e conectar assistentes. A mesma chave sh_live_… autoriza a API REST pública e o servidor MCP oficial. Os conectores sob Configurações → Conectores são uma funcionalidade diferente: eles conectam servidores MCP de terceiros ao chat dentro do aplicativo.
Criar uma chave
- Abra Configurações → API.
- Clique em Nova chave, dê um nome a ela (por exemplo,
Servidor de produção) e copie-a imediatamente. Apenas o prefixo é armazenado; o segredo completo é exibido apenas uma vez. - Envie
Authorization: Bearer sh_live_…do seu servidor. Nunca coloque uma chave em um navegador, em um aplicativo móvel ou em um repositório público.
Você pode manter até 10 chaves ativas. Revogue uma chave vazada na mesma página.
Verifique uma chave com GET /v1/me (e-mail, plano e carteira). URL base: https://api.speechdash.com/v1.
Endpoints REST
Todas as rotas HTTP públicas:
| Método | Caminho | Propósito |
|---|---|---|
GET | /health | Saúde do serviço (sem chave de API; não está sob /v1) |
GET | /v1/openapi.json | Contrato OpenAPI 3.1 |
GET | /v1/me | Conta, plano e carteira |
GET | /v1/documents | Lista de documentos da biblioteca, incluindo transcrições finalizadas |
POST | /v1/documents | Cria um documento de texto (source=api) |
GET | /v1/documents/{document_id} | Lê um documento e seu texto |
PUT | /v1/documents/{document_id} | Atualiza título, texto, idioma, is_archived ou visibility |
DELETE | /v1/documents/{document_id} | Exclui um documento |
POST | /v1/documents/{document_id}/translate | Nova versão traduzida (mesmo crédito que o export para MP3) |
GET | /v1/documents/{document_id}/export | Baixa pdf, docx, txt, csv, srt ou vtt |
POST | /v1/audio/speech | Sintetiza até 5.000 caracteres (JSON + áudio) |
POST | /v1/audio/stream | Transmite WAV, até 20.000 caracteres |
POST | /v1/audio/stream/with-timestamps | SSE com áudio por frase e marcas |
GET | /v1/voices | Catálogo de vozes |
GET | /v1/voices/{voice_id} | Uma configuração de voz (por exemplo F1) |
A API não inicia tarefas de transcrição de áudio ou vídeo. Tarefas concluídas aparecem como documentos da biblioteca (source=transcription). Páginas interativas para testar: Conta, Documentos, Áudio, Vozes.
Ferramentas MCP
O servidor oficial em https://mcp.speechdash.com/mcp expõe uma ferramenta por biblioteca ou ação de fala. O ChatGPT usa OAuth. O Cursor e o Claude Desktop usam Streamable HTTP com sua chave de API pessoal.
| Ferramenta 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 |
Recurso: speechdash://openapi (JSON OpenAPI ao vivo).
A síntese de fala em streaming (POST /v1/audio/stream e POST /v1/audio/stream/with-timestamps) não possui ferramenta MCP. Use REST para essas rotas e para /health.
Configuração: Servidor MCP e o Agents hub.
Créditos
A síntese de fala (REST e MCP) gasta 0,5 créditos por cada 30 segundos de áudio gerado iniciados. A tradução usa a mesma taxa que o export para MP3. Criar documentos e exportar arquivos não gastam créditos. Criar documentos conta para o limite diário de documentos do seu plano.
Veja O que consome créditos.