Introduzione
Invia fino a 1000 caratteri di testo inglese e, facoltativamente, quanto la lettura deve essere espressiva, variata e strettamente guidata. Il task restituisce un file WAV (24 kHz, 16 bit, mono) letto nella voce integrata di Chatterbox o nella voce di un breve clip che invii in reference_audio_url. I tag come vengono letti ad alta voce, quindi scrivi invece i suoni per esteso. SpicyAPI non applica alcun filtro dei contenuti: gli script senza filtri vengono letti così come sono scritti. Ogni richiesta costa lo stesso prezzo fisso.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Audio |
| Campo obbligatorio | text — da 1 a 1000 caratteri in inglese |
| Campi facoltativi | exaggeration (0–1), temperature (0,05–2), |
| Risultato | Un file WAV, 24 kHz, 16 bit, mono |
| Voce | Voce integrata o clonata da |
| Quantità fatturata | Un prezzo fisso per richiesta |
| Conservazione | L’audio generato viene conservato per 14 giorni |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
text | Sì | Fino a 1000 caratteri di inglese, letti esattamente come scritti. I tag come vengono letti ad alta voce; scrivi invece i suoni per esteso. almeno 1 caratteri · al massimo 1000 caratteri |
reference_audio_url | No | Clip MP3 o WAV facoltativo della voce da imitare: caricalo o indica un URL pubblico. La lettura assume il timbro di quel clip; le sue parole non vengono ripetute. almeno 1 caratteri |
exaggeration | No | Quanto è emotiva la lettura, da 0 (piatta) a 1 (drammatica). Valore predefinito: 0,5. |
temperature | No | Variazione tra le prove, da 0,05 a 2. Valore predefinito: 0,7. |
guidance_scale | No | Quanto la lettura segue il ritmo naturale del testo, da 0,1 a 1. Valore predefinito: 0,5; abbassalo per rallentare una lettura affrettata. |
Prezzi
$0.036 / richiesta
Un prezzo fisso per richiesta fino a 1000 caratteri.
Casi d’uso
Battute per giochi e animazioni
Battute di personaggio brevi e incisive, dove l’energia conta più della scelta del timbro. Aumenta exaggeration per battute urlate, ridenti o senza fiato.
Voci prototipo
Metti una voce su una demo, uno storyboard o un chatbot prima di scegliere la voce definitiva, a un prezzo fisso per battuta.
Storie audio senza censura
Gli script senza filtri vengono letti così come sono scritti. Nei nostri test il modello ha pronunciato ogni parola dei monologhi e delle narrazioni inviati, e anche i suoni scritti per esteso.
Tracce vocali per video
Genera qui la battuta, poi passa il WAV a un modello di avatar parlante o di lip-sync perché un volto la interpreti.
Consigli avanzati
Invia lo script come testo
Fino a 1000 caratteri di inglese, con la punteggiatura per le pause. Scrivi per esteso risate e sospiri: i tag vengono letti ad alta voce.
Imposta l’energia
exaggeration usa 0,5 come valore predefinito. Aumentalo per battute drammatiche o senza fiato, abbassalo per una narrazione calma.
Rifinisci se serve
Abbassa
guidance_scaleper rallentare una lettura affrettata; aumenta temperature per più varietà tra le prove.
Cosa restituisce
Un file WAV per task: 24 kHz, 16 bit, PCM mono. Il file viene copiato nello storage di SpicyAPI e conservato per 14 giorni. Il risultato non include timing per parola né sottotitoli.
La voce
Chatterbox è il modello inglese open source di Resemble AI (licenza MIT). Senza riferimento legge con la sua voce integrata; non c’è un elenco di voci. Invia un breve clip MP3 o WAV in reference_audio_url per clonare una voce: la lettura assume il timbro del clip, non le sue parole. Funzionano meglio pochi secondi di una sola voce pulita, senza musica, e devi avere il diritto di usare quella voce.
Controlli
exaggeration(0–1, predefinito 0,5): quanto è emotiva la lettura.temperature(0,05–2, predefinito 0,7): variazione tra le prove.guidance_scale(0,1–1, predefinito 0,5): quanto la lettura segue il ritmo del testo; circa 0,3 rallenta una resa veloce e drammatica.
Nei nostri test, tag come <laugh>, <sigh> o [gasp] sono stati letti ad alta voce come parole. Scrivi invece i suoni per esteso: "ah…", "mmm…", "ahh…".
Lunghezza
text accetta fino a 1000 caratteri. Nei nostri test, un paragrafo di 270 caratteri ha prodotto circa 15 secondi di audio; la maggior parte dei task finiva in 10-30 secondi.
Fatturazione
Un prezzo fisso per richiesta. Le richieste fallite non vengono addebitate.
Contenuti
SpicyAPI non applica alcun filtro sui contenuti. Nei nostri test gli script senza filtri sono stati letti parola per parola, senza saltare nulla e senza che alcun clip finisse in anticipo.
SpicyAPI non aggiunge alcun filtro dei contenuti: gli script vengono letti come scritti, senza alcun ammorbidimento. Sei responsabile degli script che invii e di come usi l’audio risultante, incluso non farlo passare per le parole di una persona reale.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
