Claves API y servidor MCP oficial
Crea claves API, llama a cada punto final REST público y conecta el servidor MCP oficial de Speechdash.
Usa Configuración → API para crear claves y conectar asistentes. La misma clave sh_live_… autoriza la API REST pública y el servidor MCP oficial. Los conectores bajo Configuración → Conectores son una función diferente: adjuntan servidores MCP de terceros al chat en la aplicación.
Crear una clave
- Abre Configuración → API.
- Haz clic en Nueva clave, ponle un nombre (por ejemplo
Servidor de producción) y cópiala inmediatamente. Solo se almacena el prefijo; la clave secreta completa se muestra una sola vez. - Envía
Authorization: Bearer sh_live_…desde tu servidor. Nunca coloques una clave en un navegador, una aplicación móvil o un repositorio público.
Puedes mantener hasta 10 claves activas. Revoca una clave filtrada desde la misma página.
Verifica una clave con GET /v1/me (correo electrónico, plan y billetera). URL base: https://api.speechdash.com/v1.
Puntos finales REST
Todas las rutas HTTP públicas:
| Método | Ruta | Propósito |
|---|---|---|
GET | /health | Salud del servicio (sin clave API; no está bajo /v1) |
GET | /v1/openapi.json | Contrato OpenAPI 3.1 |
GET | /v1/me | Cuenta, plan y billetera |
GET | /v1/documents | Lista de documentos de la biblioteca, incluyendo transcripciones terminadas |
POST | /v1/documents | Crea un documento de texto (source=api) |
GET | /v1/documents/{document_id} | Lee un documento y su texto |
PUT | /v1/documents/{document_id} | Actualiza el título, texto, idioma, is_archived o visibility |
DELETE | /v1/documents/{document_id} | Elimina un documento |
POST | /v1/documents/{document_id}/translate | Nueva versión traducida (misma cantidad de créditos que la exportación a MP3) |
GET | /v1/documents/{document_id}/export | Descarga pdf, docx, txt, csv, srt o vtt |
POST | /v1/audio/speech | Sintetiza hasta 5,000 caracteres (JSON + audio) |
POST | /v1/audio/stream | Transmite WAV, hasta 20,000 caracteres |
POST | /v1/audio/stream/with-timestamps | SSE con audio por oración y marcas |
GET | /v1/voices | Catálogo de voces |
GET | /v1/voices/{voice_id} | Una configuración de voz (por ejemplo F1) |
La API no inicia trabajos de transcripción de audio o video. Los trabajos terminados aparecen como documentos de la biblioteca (source=transcripción). Páginas interactivas para probar: Cuenta, Documentos, Audio, Voces.
Herramientas MCP
El servidor oficial en https://mcp.speechdash.com/mcp expone una herramienta por cada acción de biblioteca o voz. ChatGPT usa OAuth. Cursor y Claude Desktop usan HTTP Streamable con tu clave API personal.
| Herramienta 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 en vivo).
La síntesis de voz en streaming (POST /v1/audio/stream y POST /v1/audio/stream/with-timestamps) no tiene herramienta MCP. Usa REST para esas rutas y para /health.
Configuración: Servidor MCP y el Agents hub.
Créditos
La síntesis de voz (REST y MCP) gasta 0.5 créditos por cada 30 segundos de audio generado iniciados. La traducción usa la misma tasa que la exportación a MP3. Crear documentos y exportar archivos no gastan créditos. Crear documentos cuenta hacia el límite diario de documentos de tu plan.
Consulta ¿Qué usa créditos?.