Alibaba
Qwen Audio 3.0 TTS
qwen-audio-3.0-tts-flash
La serie di sintesi vocale multilingue gestita di Alibaba Tongyi, che include due livelli: Flash a bassa latenza e Plus ad alta qualità audio, con supporto per il controllo dell'emozione e dello stile espressivo tramite istruzioni in linguaggio naturale
Prova qwen-audio-3.0-tts-flash
Input
Output
Prezzi
qwen-audio-3.0-tts-flash per 1,000 characters
| Prezzo unitario | $0.030 |
|---|
Panoramica
qwen-audio-3.0-tts-flash è il modello di sintesi vocale da testo della serie Qwen Audio 3.0 TTS pensato per l'interazione in tempo reale, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Converte il testo di input in parlato naturale, supporta prompt in 16 lingue tra cui cinese, inglese, giapponese e coreano, e consente di regolare emozioni e stile espressivo tramite istruzioni in linguaggio naturale. È adatto a sviluppatori che costruiscono assistenti vocali, applicazioni conversazionali, annunci per il servizio clienti e doppiaggio multilingue, in particolare per scenari in tempo reale sensibili alla latenza del primo pacchetto e che richiedono un equilibrio tra velocità di risposta e qualità audio. Il limite di testo per singola attività è di 20000 punti di codice Unicode.
Punti di forza
- Livello a bassa latenza per l'interazione in tempo reale——l'orientamento Flash è la risposta in tempo reale, con latenza del primo pacchetto nell'ordine dei 300 millisecondi, adatto a catene di dialogo sincrono e annunci vocali.
- Controllo a istruzioni di emozioni e stile espressivo——tramite il campo opzionale instruction è possibile descrivere tono e modalità espressiva, riducendo le successive lavorazioni in post-produzione audio.
- Ampia copertura di sintesi multilingue——supporta prompt in 16 lingue; lo stesso modello può servire contenuti in più lingue senza cambiare modello in base alla lingua.
- Formato di output e frequenza di campionamento selezionabili——supporta quattro output pcm, wav, mp3 e opus, con frequenza di campionamento da 8000 a 48000 Hz selezionabile in base al dispositivo di riproduzione.
Descrizione delle capacità
Sintesi vocale multilingue da testo: dato un testo e una voce è possibile sintetizzare il parlato; language_hints consente di specificare la lingua di destinazione, coprendo la produzione di contenuti multilingue con un'unica integrazione.
Regolazione fine dei parametri vocali: velocità e tono regolabili nell'intervallo da 0,5 a 2 volte, volume da 0 a 100, per adattarsi a diversi dispositivi di riproduzione e ritmi dei contenuti.
Controllo di formato di output e frequenza di campionamento: è possibile scegliere output mp3, wav, pcm o opus, con frequenza di campionamento da 8000 a 48000 Hz; con opus si può inoltre specificare un bitrate da 6 a 510 kbps.
Controllo tramite istruzioni e seed: il campo instruction descrive lo stile di sintesi, mentre seed consente di fissare il seme casuale per riprodurre lo stesso risultato di sintesi e stabilizzare i test di regressione.
Sintesi di testi lunghi in un'unica attività: una singola attività accetta fino a 20000 punti di codice Unicode, senza necessità di suddividere i paragrafi lunghi lato chiamante.
Scenari di utilizzo
- Sviluppatori di assistenti vocali in tempo reale: testo delle risposte dialogiche——sintetizzare in tempo reale le risposte del sistema dialogico e collegarle direttamente alla fase di annuncio di assistenti vocali o applicazioni conversazionali.
- Servizio clienti e call center: testi degli annunci——convertire in blocco copioni standard e contenuti di notifica in parlato, per chiamate outbound, messaggi IVR e annunci di stato dei ticket.
- Istruzione online e contenuti audio: materiali dei corsi——sintetizzare lezioni e copioni in audio con velocità regolabile, per doppiaggio di corsi e produzione di audiolibri.
- Team di contenuti multilingue: testi in più lingue——sintetizzare versioni in lingue diverse dello stesso testo in base ai suggerimenti di lingua, per l'internazionalizzazione dei prodotti e il doppiaggio di video multilingue.
Limitazioni e consigli di selezione
Questo modello appartiene al livello Flash, con priorità alla velocità di risposta: la naturalezza e la fedeltà della voce sono inferiori rispetto alla variante Plus della stessa serie, pertanto per scenari che richiedono alta qualità del prodotto finale si consiglia di passare a Plus. Le voci di sistema offrono solo quattro valori selezionabili e non è possibile progettare una voce da una descrizione testuale; la capacità di clonazione vocale non rientra nei parametri di questo modello. La sintesi viene misurata in base ai caratteri di output, con i caratteri CJK conteggiati come due caratteri; per la generazione in blocco di testi lunghi è necessario stimare il consumo. La distribuzione self-hosted o i pesi open source non rientrano nell'ambito di applicazione di questo modello.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: qwen-audio-3.0-tts-flash
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per qwen-audio-3.0-tts-flash e la route default — vedi la tabella dei parametri sotto.
ratenumberOpzionalePredefinito: 1min 0.5max 2Moltiplicatore della velocità del parlato, predefinito 1, ovvero velocità normale; un valore maggiore di 1 indica accelerazione, minore di 1 indica rallentamento.
seedintegerOpzionalePredefinito: 0min 0max 65535Seme casuale per una sintesi deterministica, predefinito 0; lo stesso seme e lo stesso input rendono riproducibile il risultato della sintesi.
textstringObbligatoriominLength 1maxLength 20000Il testo da sintetizzare in parlato. hiAPI accetta al massimo 20.000 punti di codice Unicode per ogni attività; nella fatturazione Alibaba i caratteri ideografici CJK contano come due caratteri, gli altri caratteri come uno.
pitchnumberOpzionalePredefinito: 1min 0.5max 2Moltiplicatore del tono, predefinito 1, ovvero altezza originale; un valore maggiore aumenta il tono, uno minore lo abbassa.
voicestringObbligatorioPredefinito: "longanhuan_v3.6"Specifica la voce di sistema supportata dal livello Flash, predefinita longanhuan_v3.6.
longanhuan_v3.6longjielidou_v3.6loongeva_v3.6loongjohnformatstringOpzionalePredefinito: "mp3"Formato contenitore dell'audio di output oppure formato PCM grezzo, predefinito mp3.
pcmwavmp3opusvolumeintegerOpzionalePredefinito: 50min 0max 100Volume di output, intervallo di valori da 0 a 100, predefinito 50.
bit_rateintegerOpzionalePredefinito: 32min 6max 510Bitrate della codifica Opus, in kbps, predefinito 32; questo parametro ha effetto solo quando format è opus.
instructionstringOpzionaleminLength 1Istruzione opzionale sullo stile di sintesi, utilizzata per aggiungere requisiti di controllo della sintesi; se non fornita, la sintesi avviene in modalità predefinita.
sample_rateintegerOpzionalePredefinito: 22050Frequenza di campionamento dell'audio di output, in Hz, predefinita 22050.
80001600022050240004410048000language_hintsarrayOpzionaleminItems 1maxItems 1Array opzionale di suggerimenti sulla lingua; Qwen elabora solo il primo elemento dell'array.
Array [ string ]
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-audio-3.0-tts-flash",
"input": {
"rate": 1,
"seed": 0,
"text": "…",
"pitch": 1,
"voice": "longanhuan_v3.6",
"format": "mp3",
"volume": 50,
"bit_rate": 32,
"sample_rate": 22050
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "qwen-audio-3.0-tts-flash",
input: {
"rate": 1,
"seed": 0,
"text": "…",
"pitch": 1,
"voice": "longanhuan_v3.6",
"format": "mp3",
"volume": 50,
"bit_rate": 32,
"sample_rate": 22050
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "qwen-audio-3.0-tts-flash",
"input": {
"rate": 1,
"seed": 0,
"text": "…",
"pitch": 1,
"voice": "longanhuan_v3.6",
"format": "mp3",
"volume": 50,
"bit_rate": 32,
"sample_rate": 22050
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
MiniMax Music 1.5 MiniMax $0.070 /brano -
Lyria 3 Pro Google $0.140 /brano -
Lyria 3.5 Google $0.090 /brano -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 3 MiniMax $0.0026 /secondo -
MiniMax Music 2.6 MiniMax $0.210 /brano -
ElevenLabs ElevenLabs $0.0029 /secondo -
Mirelo SFX 2.0 Mirelo AI $0.021 /secondo -
Gemini 3.1 Flash TTS Google --
Stesso fornitore
-
Z-Image Alibaba $0.008 /immagine -
Wan 3.0 Video Alibaba $0.040 /secondo -
Wan 2.7 Image Alibaba $0.035 /immagine -
HappyHorse 1.1 Alibaba $0.160 /secondo -
HappyHorse 1.0 Alibaba $0.168 /secondo -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Wan 2.7 Video Alibaba $0.100 /secondo -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Qwen Image 3.0 Alibaba $0.036 /immagine