L’API pubblica Speechdash è online

L’API pubblica Speechdash è disponibile su api.speechdash.com/v1. Se sviluppi prodotti in cui serve ascoltare testo, puoi creare documenti e generare voce senza aprire l’interfaccia web.

Questo articolo riassume cosa è disponibile, come funziona la fatturazione e come inviare la prima richiesta in pochi minuti.

Cosa permette l’API oggi

L’API REST riprende lo stack di ascolto che già conosci dall’app:

• Creare e gestire documenti nella libreria Speechdash di un utente (importazione testo con titolo e lingua)
• Generare voce con i preset Narratore, Interlocutore ed Esperto in molte lingue
• Elencare, leggere, aggiornare ed eliminare documenti tramite endpoint JSON prevedibili

I documenti creati via API compaiono nella libreria su speechdash.com. I tuoi utenti possono continuare ad ascoltare nell’app, modificare il testo, esportare l’audio o riprendere su un altro dispositivo.

La sintesi vocale usa le stesse voci cloud della riproduzione in app. L’utilizzo viene scalato dal portafoglio crediti dell’account, con le stesse regole dell’ascolto cloud nel prodotto.

A chi serve

I team scelgono l’API quando l’ascolto deve vivere dentro un altro prodotto:

• LMS e piattaforme di studio con lettura ad alta voce su compiti o articoli
• Strati di accessibilità in strumenti SaaS
• Strumenti interni che importano contenuti in blocco per revisione a orecchio
• Prototipi che servono un’anteprima parlata prima di un’interfaccia completa

Se i tuoi utenti hanno già un account Speechdash, mantengono un solo portafoglio e una sola libreria. L’API è un ingresso in più, non un prodotto separato.

Autenticazione e documentazione

Ogni account crea chiavi API in Impostazioni → API su speechdash.com/settings/api. La chiave viene mostrata una sola volta; lato server resta solo un prefisso.

Invia Authorization: Bearer sh_live_… a ogni richiesta. Chiavi non valide o revocate ricevono 401.

La documentazione per sviluppatori è nel centro assistenza:

• Panoramica API (autenticazione, limiti, fatturazione, idempotenza)
• Contratto OpenAPI live su api.speechdash.com/v1/openapi.json

La pagina prodotto API pubblica riassume l’offerta per chi non sviluppa nel team.

Fatturazione in sintesi

Le richieste vocali bloccano una stima, poi regolano sulla durata misurata. Nei tentativi successivi puoi inviare Idempotency-Key alla creazione documento e alla sintesi per evitare un doppio addebito dopo un problema di rete.

I limiti di frequenza valgono per account (non per chiave). Le risposte includono le intestazioni standard e Retry-After quando conviene attendere.

Prima richiesta in cinque minuti

1. Accedi su speechdash.com e apri Impostazioni → API
2. Crea una chiave e copiala subito
3. Leggi la panoramica API
4. Esegui un POST con testo breve su /v1/documents oppure chiama /v1/audio/speech con preset voce e lingua

Inizia con due frasi prima di elaborare un intero capitolo. La panoramica elenca i campi esatti e risposte di esempio.

Prossimi passi

Estenderemo l’API con le esigenze del prodotto. Se integri ora, unisciti a Discord per feedback anticipati o apri il centro assistenza se qualcosa nel contratto non è chiaro.

Grazie per costruire con Speechdash. Non vediamo l’ora di vedere cosa pubblichi.

Guide correlate

• Pagina funzionalità API pubblica
• Iniziare con Speechdash
• Riproduzione cloud
• Formati di importazione
• Cosa consuma i crediti