Introduzione
Descrivi l'intera scena audio in un unico prompt: chi parla, come, e le battute tra virgolette, più eventuale musica, ambiente o effetti sonori. L'attività restituisce un file audio fino a circa due minuti con tutto ciò che hai descritto, compreso il dialogo di più parlanti: un MP3, a meno che tu non imposti output_format. Per riutilizzare una voce, carica fino a tre clip di riferimento in reference_audio_urls e chiamale @Audio1 fino a @Audio3 nel prompt, oppure indica un'immagine di riferimento in image_url; speed, pitch e volume regolano finemente l'interpretazione. SpicyAPI non applica alcun filtro sui contenuti: ogni prompt viene letto così com'è scritto. Ogni richiesta costa lo stesso prezzo fisso.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Audio |
| Campo obbligatorio | prompt — da 1 a 2.000 caratteri |
| Campi opzionali |
|
| Risultato | Un file audio di massimo circa due minuti: MP3 per impostazione predefinita, oppure WAV, Ogg Opus, PCM |
| Speaker | Più di uno, descritti nel prompt o presi da fino a tre clip di reference; nessuna lista di voci |
| Quantità fatturata | Un prezzo fisso per richiesta |
| Conservazione | L'audio generato viene conservato 14 giorni |
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi l'intera scena in massimo 2.000 caratteri: ogni speaker e come suona, le sue battute esatte tra virgolette, e qualsiasi musica, ambiente o effetto sonoro. almeno 1 caratteri · al massimo 2000 caratteri |
reference_audio_urls | No | Fino a tre clip MP3 o WAV di riferimento: caricale o indica URL pubblici. Ogni clip può durare fino a 30 secondi e pesare fino a 10 MB. al massimo 3 elementi |
image_url | No | Immagine di riferimento facoltativa attorno a cui viene costruito l'audio: caricala o indica un URL pubblico, poi descrivi nel prompt cosa dice la persona ritratta o come suona… almeno 1 caratteri |
speed | No | Velocità del parlato da 0,5 (più lenta) a 2 (più veloce); 1 è il ritmo normale della voce. Non cambia il prezzo. |
pitch | No | Spostamento dell'intonazione in semitoni, da -12 a 12; 0 mantiene l'altezza naturale della voce. Non cambia il prezzo. |
volume | No | Moltiplicatore del volume da 0,5 a 2; 1 è il livello normale. Non cambia il prezzo. |
output_format | No | Formato del file: mp3 (predefinito), wav, opus (Ogg Opus) oppure pcm, cioè campioni stereo grezzi a 16 bit little-endian, interlacciati e senza intestazione, al |
sample_rate | No | Frequenza di campionamento dell'audio in Hz: 8000, 16000, 24000, 32000, 44100, 48000. Valore predefinito: 24000. |
Prezzi
$0.36 / richiesta
Un prezzo fisso per richiesta, una clip di massimo circa due minuti.
Casi d’uso
Audiodrammi multi-personaggio
Descrivi due o più speaker e metti le loro battute tra virgolette, e il modello dà a ciascuno una voce distinta nella stessa clip — senza bisogno di un modello vocale separato per ogni personaggio.
Scene con sound design
Un solo prompt può richiedere insieme dialogo, musica di sottofondo, ambiente e effetti sonori, così una singola richiesta restituisce una scena completa invece di una semplice battuta vocale.
Fiction audio senza censure
I prompt vengono letti così come sono scritti, senza filtro sui contenuti. Nei nostri test un monologo in prima persona, una finzione narrata e una scena con ambiente di pioggia, tutti scritti oltre ciò che altri servizi accettano, sono tornati con ogni parola pronunciata.
Tracce vocali per video
Genera la scena qui, poi passa l'MP3 a un modello talking-avatar o lip-sync perché un volto la interpreti.
Consigli avanzati
Descrivi gli speaker
Indica chi parla e come — un sussurro senza fiato, un narratore caldo — e metti le loro parole esatte tra virgolette.
Aggiungi il paesaggio sonoro
Cita qualsiasi musica, ambiente o effetto sonoro che vuoi accanto al dialogo: un temporale, un orologio che ticchetta, una colonna sonora che cresce.
Resta entro i 2.000 caratteri
Un prompt copre una scena di massimo circa due minuti; storie più lunghe vanno divise su più richieste.
Cosa restituisce
Un file audio per task, di massimo circa due minuti: un MP3, salvo che tu cambi output_format. Il file viene copiato nello storage di SpicyAPI e conservato 14 giorni.
Come scrivere il prompt
Seed Audio 1.0 accetta un solo campo prompt (massimo 2.000 caratteri) che descrive l'intera scena:
- Chi parla e come — un sussurro, un narratore caldo, una battuta gridata.
- Le loro parole esatte, tra virgolette.
- Qualsiasi musica, ambiente o effetto sonoro che vuoi accanto al dialogo.
Questo modello supporta più di uno speaker nella stessa clip: descrivi ogni personaggio e le sue battute, e dà a ciascuno una voce distinta.
Audio e immagine di reference
Non c'è una lista di voci. Per riusare una voce o un suono, carica fino a tre clip in reference_audio_urls e chiamale nel prompt @Audio1, @Audio2 e @Audio3, nell'ordine di caricamento, per esempio “Con la voce di @Audio1, un uomo dice …”. Oppure fornisci un'immagine in image_url e descrivi cosa dice la persona ritratta o come suona la scena; i due input non si combinano. Usa solo voci e immagini che hai il diritto di usare.
Resa e formato
speed (0,5–2), pitch (da -12 a 12 semitoni) e volume (0,5–2) rifiniscono la resa. output_format sceglie mp3 (predefinito), wav, opus (Ogg Opus) o pcm, e sample_rate va da 8000 a 48000 Hz. pcm sono campioni stereo grezzi a 16 bit little-endian senza intestazione, quindi non si possono ascoltare nel browser; scegli wav per avere gli stessi campioni in un file riproducibile. Nessuna di queste opzioni cambia il prezzo.
Fatturazione
Un prezzo fisso per richiesta, qualunque sia la lunghezza del prompt. Le richieste fallite non vengono addebitate.
Contenuto
SpicyAPI non aggiunge alcun filtro sui contenuti. Nei nostri test, tre prompt che altri servizi rifiutano — un monologo in prima persona, una finzione narrata e una scena con ambiente di pioggia — sono tornati tutti con ogni parola pronunciata.
SpicyAPI non aggiunge alcun filtro sui contenuti: i prompt vengono letti così come sono scritti, qualunque sia il loro contenuto. Sei responsabile delle scene che descrivi 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": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"output_format": "mp3",
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 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.
