Introduzione
Invia il testo da leggere e, facoltativamente, una voce, un accento, uno stile di parlato, un ritmo, una scena e una breve nota sull'interpretazione; per una conversazione, invia battute e parlanti al posto del testo. L'attività restituisce un file WAV (24 kHz, 16 bit, mono) con il copione letto in quella voce, oppure in al massimo due voci per un dialogo. Il modello segue indicazioni in linguaggio semplice (più lento, più vicino al microfono, divertito, stanco) ed esegue le indicazioni tra parentesi quadre, come [sighs], invece di leggerle ad alta voce. SpicyAPI non applica alcun filtro sui contenuti: ogni copione viene letto così come è scritto. Si addebita per secondo di audio restituito.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Audio |
| Campo obbligatorio | text (da 1 a 5.000 caratteri) o dialogue (fino a 20 battute) |
| Campi opzionali |
|
| Risultato | Un file WAV, 24 kHz, 16 bit, mono |
| Clip più lunga | Circa 655 secondi (16.384 token audio) |
| Quantità fatturata | Secondi di audio restituiti, misurati sul file |
| Conservazione | L'audio generato viene conservato per 14 giorni |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
text | No | Le parole da pronunciare, esattamente come sono scritte. Le annotazioni tra parentesi quadre come [sighs] vengono recitate, non lette. almeno 1 caratteri · al massimo 5000 caratteri |
dialogue | No | Un dialogo con copione per un massimo di due voci, al posto di text: fino a 20 battute, ognuna con speaker (un nome preso da speakers) e un text di massimo 250 caratteri. almeno 1 elementi · al massimo 20 elementi |
speakers | No | Il cast di dialogue: una o due voci, ognuna con un name a cui fanno riferimento le battute, un |
voice_id | No | Una delle 30 voci predefinite, ciascuna con un carattere fisso. Predefinita: Kore. |
style | No | Modo generale della lettura. Lascialo vuoto per usare il modo predefinito della voce. |
pace | No | Ritmo della lettura: natural, |
accent | No | Accento inglese usato per la lettura. Predefinito: neutral. |
instructions | No | Indicazione libera su come leggere: ritmo, stato d'animo, distanza dal microfono, ascoltatore. Plasma l'interpretazione e non viene pronunciata. al massimo 1000 caratteri |
scene | No | Dove e a chi vengono dette le parole, per esempio “una stanza d'albergo silenziosa dopo mezzanotte”. Orienta l'interpretazione e non viene letto. al massimo 500 caratteri |
temperature | No | Variazione tra le prove, da 0 a 2: valori più alti rendono l'interpretazione meno prevedibile. Se non lo imposti, si usa il valore predefinito del modello. |
Prezzi
$0.00045 / secondo
Fatturato per ogni secondo di audio restituito. Durante il task viene bloccato l'importo di 660 secondi e la parte non usata viene sbloccata quando l'audio è misurato.
Casi d’uso
Audiolibri e narrazione lunga
Capitoli, favole della buonanotte e narrativa a puntate letti da una voce narrante costante. Scegli una voce una volta e tienila: la stessa voce con le stesse indicazioni suona uguale da un capitolo all'altro.
Voci per personaggi e companion
Dai a un personaggio della chat una voce tutta sua. Uno stile sussurrato e una breve indicazione trasformano un testo piatto in battute che sembrano rivolte a una sola persona, non annunciate.
Storie audio senza censura
I copioni vengono letti così come sono scritti, senza filtro sui contenuti. Nei nostri test il modello ha pronunciato ogni parola sia delle battute in prima persona sia delle scene narrate, senza saltare parole né chiudere la clip in anticipo.
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 reciti. La durata dell'audio stabilisce la durata della clip nel passaggio successivo.
Consigli avanzati
Invia il copione in text
Scrivilo esattamente come deve essere detto, con la punteggiatura per le pause. Fino a 5.000 caratteri.
Scegli una voce e, se serve, uno stile e un accento
voice_idvale Kore per impostazione predefinita e accent vale neutral. Aggiungi style solo quando vuoi un modo preciso, come whisper.Dirigi la lettura in instructions
Una o due frasi su ritmo, stato d'animo e ascoltatore funzionano meglio di un elenco di aggettivi. L'indicazione non viene letta.
Cosa restituisce
Un file WAV per task: PCM a 24 kHz, 16 bit, mono. Il file viene copiato nello storage di SpicyAPI e conservato per 14 giorni. Il risultato non contiene tempi per parola né sottotitoli.
Scegliere la voce
voice_id accetta una delle 30 voci predefinite e il valore predefinito è Kore. Ogni voce ha un carattere fisso, per esempio Kore decisa, Charon informativa, Puck vivace, Enceladus soffiata, Achernar morbida, Algenib roca, Sulafat calda, Gacrux matura. La voce non cambia con la lingua del copione.
Dirigere la lettura
styleimposta un modo generale:whisper,empathetic,vocal_smile,newscaster,promo_hypeodeadpan. Se lo ometti, la voce legge nel suo modo predefinito.accentsceglie un accento inglese, predefinitoneutral.pacedà il ritmo:natural,rapid_fire,the_driftostaccato.instructionsaccoglie testo libero su come leggere: ritmo, stato d'animo, distanza dal microfono, a chi ci si rivolge.scenedice dove e a chi vengono dette le parole. Nessuno dei due viene letto.temperature(0–2) stabilisce quanto varia la resa tra una prova e l'altra.- Dentro
text, le indicazioni tra parentesi quadre come[sighs]o[whispering]vengono recitate invece che lette.
Due voci in una clip
Per una conversazione, invia dialogue al posto di text, insieme a speakers con il cast: una o due voci, ognuna con un name, un voice_id e, facoltativi, accent, style, pace e profile, una breve descrizione di chi parla che non viene letta. Ogni battuta di dialogue è {speaker, text}, dove speaker è uno di quei nomi; le battute vengono recitate in ordine, fino a 20 battute da 250 caratteri ciascuna. Ciò che una voce non imposta viene preso da accent, style e pace di primo livello. L'intera conversazione torna come un unico file WAV, pagato al secondo come qualsiasi altra richiesta.
Durata e tempi
text accetta fino a 5.000 caratteri. Nei nostri test, un paragrafo di 270 caratteri ha prodotto 23–29 secondi di audio a seconda della voce e dello stile. Il modello si ferma a 16.384 token audio, circa 655 secondi. La maggior parte dei task termina in meno di un minuto.
Fatturazione
Fatturato per ogni secondo di audio restituito, misurato sul file. Mentre il task è in corso, sul saldo viene bloccato l'importo di 660 secondi — la clip più lunga che il modello può produrre — e la parte non usata viene sbloccata alla chiusura del task. Le richieste non riuscite non vengono addebitate.
Contenuti
SpicyAPI non aggiunge alcun filtro sui contenuti. Nei nostri test i copioni che altri servizi rifiutano sono stati letti parola per parola, senza saltare nulla e senza clip interrotte in anticipo.
SpicyAPI non aggiunge alcun filtro sui contenuti: i copioni vengono letti così come sono scritti, qualunque sia il loro contenuto. Sei responsabile dei copioni che invii e dell'uso che fai dell'audio ottenuto, incluso il non farlo passare per 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": "google/gemini-2.5-pro-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"accent": "neutral",
"voice_id": "Kore"
}
}'
# 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.







