Chiavi API e MCP
Crea chiavi API, chiama ogni endpoint REST pubblico e connetti il server MCP ufficiale di Speechdash.
Usa Impostazioni → API per creare chiavi e connettere assistenti. La stessa chiave sh_live_… autorizza sia la API REST pubblica che il server MCP ufficiale. I connettori sotto Impostazioni → Connettori sono una funzionalità diversa: collegano server MCP di terze parti alla chat in-app.
Crea una chiave
- Apri Impostazioni → API.
- Clicca su Nuova chiave, dale un nome (ad esempio
Server di produzione) e copiala immediatamente. Solo il prefisso viene memorizzato; il segreto completo viene mostrato una sola volta. - Invia
Authorization: Bearer sh_live_…dal tuo server. Non inserire mai una chiave in un browser, in un'app mobile o in un repository pubblico.
Puoi mantenere fino a 10 chiavi attive. Revoca una chiave compromessa dalla stessa pagina.
Verifica una chiave con GET /v1/me (email, piano e portafoglio). URL di base: https://api.speechdash.com/v1.
Endpoint REST
Ogni percorso HTTP pubblico:
| Metodo | Percorso | Scopo |
|---|---|---|
GET | /health | Stato del servizio (nessuna chiave API; non sotto /v1) |
GET | /v1/openapi.json | Contratto OpenAPI 3.1 |
GET | /v1/me | Account, piano e portafoglio |
GET | /v1/documents | Elenca i documenti della libreria, inclusi i trascritti completati |
POST | /v1/documents | Crea un documento di testo (source=api) |
GET | /v1/documents/{document_id} | Leggi un documento e il suo testo |
PUT | /v1/documents/{document_id} | Aggiorna titolo, testo, lingua, is_archived o visibility |
DELETE | /v1/documents/{document_id} | Elimina un documento |
POST | /v1/documents/{document_id}/translate | Nuova versione tradotta (stesso credito dell'esportazione in MP3) |
GET | /v1/documents/{document_id}/export | Scarica pdf, docx, txt, csv, srt o vtt |
POST | /v1/audio/speech | Sintetizza fino a 5.000 caratteri (JSON + audio) |
POST | /v1/audio/stream | Flusso WAV, fino a 20.000 caratteri |
POST | /v1/audio/stream/with-timestamps | SSE con audio per frase e segni temporali |
GET | /v1/voices | Catalogo delle voci |
GET | /v1/voices/{voice_id} | Una presets di voce (ad esempio F1) |
L'API non avvia lavori di trascrizione audio o video. I lavori completati compaiono come documenti della libreria (source=transcription). Pagine interattive per provare: Account, Documenti, Audio, Voci.
Strumenti MCP
Il server ufficiale https://mcp.speechdash.com/mcp espone uno strumento per ogni libreria o azione di discorso. ChatGPT usa OAuth. Cursor e Claude Desktop usano Streamable HTTP con la tua chiave API personale.
| Strumento 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 |
Risorsa: speechdash://openapi (JSON OpenAPI live).
La sintesi vocale in streaming (POST /v1/audio/stream e POST /v1/audio/stream/with-timestamps) non ha uno strumento MCP. Usa REST per queste rotte e per /health.
Configurazione: Server MCP e il Hub degli Agenti.
Crediti
La sintesi vocale (REST e MCP) consuma 0.5 crediti per ogni 30 secondi di audio generato. La traduzione utilizza la stessa tariffa dell'esportazione in MP3. La creazione di documenti e l'esportazione di file non consumano crediti. La creazione di documenti conta verso il limite quotidiano di documenti del tuo piano.
Vedi Cosa consuma crediti.