Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
text | Sì | The words to be spoken, exactly as written. Billed per 1,000 characters, minimum 100. |
language | No | La lingua del parlato. auto · zh · en · de · fr · es · it · pt · ru · ja · ko · Predefinito: auto |
voice_id | No | Scegli tra le voci disponibili. Serena · Vivian · Uncle_Fu · Dylan · Eric · Ryan · Aiden · Ono_Anna · Sohee · Predefinito: Serena |
instructions | No | How to read the text: tone, emotion or pace. Not spoken and not billed. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti ogni 1.000 caratteri | ≈ USD |
|---|---|---|
| Standard | 10,2 | 0,10 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 11 crediti ogni 1.000 caratteri (0,11 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Qwen3 TTS in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model alibaba/qwen-3-tts/text-to-speech e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "Serena",
"language": "auto"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Qwen3 TTS
Quanto costa l’API di Qwen3 TTS?
Qwen3 TTS costa 11 crediti (0,11 USD) ogni 1.000 caratteri. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Qwen3 TTS nell’API?
Inserisci alibaba/qwen-3-tts/text-to-speech per Sintesi vocale nel campo model di POST /jobs/createTask.
Come controllo la resa?
Scegli una delle nove voci con voice_id e descrivi la resa in instructions — tono, emozione o ritmo, in una o due frasi. Le istruzioni plasmano la lettura e non vengono lette ad alta voce.
Quali lingue legge?
Cinese, inglese, tedesco, francese, spagnolo, italiano, portoghese, russo, giapponese e coreano — due delle voci parlano i dialetti di Pechino e del Sichuan. La lingua viene rilevata dallo script, a meno che tu non imposti language.
Può copiare la voce di una persona reale?
No. Su questo endpoint sono disponibili solo le nove voci predefinite; non c'è clonazione né caricamento di una voce di riferimento.
Quali sono i limiti dell’API di Qwen3 TTS?
Lunghezza del testo (caratteri): 2,000; Voci: 9; Lingue: 10. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Qwen3 TTS senza scrivere codice?
Sì. Il Playground esegue Qwen3 TTS con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.

