Alibaba
Qwen Image 3.0
qwen-image-3.0/text-to-image
Modello di terza generazione di Alibaba per la generazione e modifica di immagini, specializzato nella composizione tipografica densa e nel rendering multilingue con prompt lunghi, supporta la modifica tramite immagini di riferimento
Prova qwen-image-3.0/text-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
qwen-image-3.0/text-to-image per image
| Prezzo unitario | $0.0358 |
|---|
Panoramica della posizione
qwen-image-3.0 è il modello di terza generazione per la generazione di immagini della serie Qwen di Alibaba, pensato per scenari di sviluppo in cui le immagini devono veicolare informazioni reali. Accetta prompt fino a 18000 caratteri ed è particolarmente adatto a generare infografiche, impaginazioni di giornali, concept di UI, griglie di prodotti e altre composizioni dense di elementi e con testo. Supporta due livelli di risoluzione, 1K e 2K, otto rapporti d'aspetto, output PNG/JPEG e seed casuali, ed è quindi uno strumento produttivo per materiali di design, prototipi di interfaccia e asset di marketing.
Punti di forza principali
- Prompt lunghi per impaginazioni complesse — il limite del prompt è di 18000 caratteri, così una sola descrizione può vincolare contemporaneamente layout a più blocchi, elementi e contenuti testuali.
- Impaginazione e testo orientati alla visualizzazione informativa — ottimizzazione mirata di impaginazioni dense, corpi piccoli e rendering multilingue, così i layout e le bozze di interfaccia generati sono più vicini a materiali utilizzabili direttamente.
- Specifiche di output controllabili — risoluzione, rapporto d'aspetto, formato file e seed casuale sono tutti specificabili e, insieme al prompt negativo e all'ottimizzazione automatica del prompt, facilitano la produzione in batch di immagini con stile coerente.
Descrizione delle capacità
Generazione di immagini complesse guidata da testi lunghi: un singolo prompt può arrivare a 18000 caratteri, usando descrizioni prolungate per specificare composizione, stile e gerarchia informativa, riducendo il costo di integrazioni ripetute del prompt in più turni.
Impaginazioni e bozze di interfaccia dense di testo: adatto a generare infografiche, impaginazioni di giornali, poster e concept di UI, cioè immagini in cui elementi e testo coesistono, con risultati più vicini a materiali di lavoro reali che a immagini puramente estetiche.
Specifiche di output controllabili con precisione: risoluzione 1K o 2K selezionabile, otto rapporti d'aspetto da 1:1 a 21:9, formato PNG o JPEG, e possibilità di riprodurre o rifinire i risultati tramite seed casuale.
Arricchimento del prompt e vincoli negativi: prompt_extend è attivo per impostazione predefinita e completa e ottimizza automaticamente il prompt, mentre negative_prompt serve a escludere elementi indesiderati, migliorando la controllabilità dell'output.
Scenari d'uso
- Generazione di materiali di impaginazione per team di design e contenuti — inserendo descrizioni di testi e layout per infografiche, impaginazioni di giornali o poster, si producono immagini utilizzabili direttamente come riferimento di impaginazione o come illustrazioni da pubblicare.
- Concept di UI per team di prodotto e frontend — descrivendo con prompt la struttura di interfacce web, di gioco o di live streaming, si generano concept per discussioni su prototipi ad alta fedeltà e revisioni di design.
- Immagini di prodotto e marketing per l'e-commerce — partendo da informazioni sul prodotto e requisiti di presentazione, si producono griglie di prodotti e asset di marketing per le bozze di pagine di dettaglio e pagine promozionali.
- Illustrazioni per contesti didattici e documentali — in base ai contenuti esplicativi si generano materiali con testo e immagini o illustrazioni per documenti, da usare come completamento visivo per corsi, pagine illustrative e materiali interni.
Limiti e consigli per la scelta
Questa linea supporta solo la generazione testo-immagine; per modificare un'immagine partendo da un'immagine di riferimento occorre passare alla linea immagine-immagine della stessa famiglia. Le informazioni sulle capacità del modello provengono principalmente da annunci del produttore e da pagine di presentazione di terze parti, e mancano valutazioni benchmark pubbliche e indipendenti: prima del lancio ufficiale si consiglia di effettuare una validazione su piccoli campioni con i prompt del proprio business. Prompt lunghi e impaginazioni dense di testo richiedono una grande precisione descrittiva, e i risultati dipendono dalla densità dell'impaginazione e dalla lingua; si consiglia di combinare seed casuali e più generazioni per selezionare i risultati. Se servono solo illustrazioni di tipo estetico convenzionale, si può usare un modello testo-immagine più leggero per contenere i costi.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello disponibile: qwen-image-3.0-pro/text-to-image
- Nuovo modello Lancio del modello image-to-image qwen-image-3.0-pro
- Nuovo modello Aggiunti qwen-image-3.0/text-to-image…
Domande frequenti
Vedi tutte le domande →-
Quante immagini di riferimento supporta l'editor di immagini Qwen Image 3.0?
Supporta da 1 a 3 immagini di riferimento. Ne serve almeno una, il campo API è input.image_urls.
-
Qual è la differenza tra l'editing di immagini Standard e Pro?
La versione Standard privilegia costi contenuti e iterazioni rapide; Pro è più adatta alla sostituzione accurata del testo, ai materiali complessi e al layout finale.
-
Come vengono fatturati 1K, 2K e le immagini di riferimento?
1K e 2K utilizzano lo stesso livello di output; per ogni immagine di riferimento è previsto un costo aggiuntivo. Gli importi esatti sono quelli del prezzo in tempo reale indicato in questa pagina.
-
Come ridurre la deriva del soggetto, del layout o del testo?
Nel Prompt, elenca separatamente i contenuti da modificare e quelli che devono essere preservati: soggetto, testo, posizione, materiale, inquadratura e illuminazione; quando serve un testo accurato, scrivi il testo desiderato tra virgolette.
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-image-3.0/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per qwen-image-3.0/text-to-image e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionalemin 0max 2147483647Seme casuale utilizzato per controllare la casualità dei risultati di generazione; assume un valore intero, lo stesso seme con gli altri parametri identici permette di riprodurre risultati simili, se non specificato viene generato casualmente dal server.
promptstringObbligatoriominLength 1maxLength 18000Prompt positivo, descrive tramite testo il contenuto, lo stile e la composizione dell'immagine desiderata ed è l'input principale per la generazione di immagini da testo.
resolutionstringOpzionalePredefinito: "1K"Livello di risoluzione dell'output, specifica come stringa il livello di nitidezza dell'immagine generata, valore predefinito 1K.
1K2Kaspect_ratiostringOpzionalePredefinito: "1:1"Proporzione larghezza-altezza dell'immagine di output, specificata come stringa di rapporto, valore predefinito 1:1.
1:13:22:34:33:416:99:1621:9output_formatstringOpzionalePredefinito: "png"Formato del file dell'immagine generata, specificato come stringa, valore predefinito png.
pngjpegprompt_extendbooleanOpzionalePredefinito: trueIndica se ottimizzare automaticamente il prompt, valore booleano; se attivato il server espande e potenzia il prompt, valore predefinito true.
negative_promptstringOpzionalePredefinito: ""maxLength 500Prompt negativo, descrive il contenuto che non si desidera compaia nell'immagine, valore predefinito stringa vuota che indica nessun vincolo di esclusione applicato.
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-image-3.0/text-to-image",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": true,
"negative_prompt": ""
}
}' 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-image-3.0/text-to-image",
input: {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": true,
"negative_prompt": ""
}
}),
});
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-image-3.0/text-to-image",
"input": {
"prompt": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": True,
"negative_prompt": ""
}
},
)
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 →-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
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
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
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
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
BRIA Product Shot Bria $0.058 /immagine -
Seedream 5.0 ByteDance $0.025 /immagine -
Imagen 4 Google $0.030 /immagine -
Ideogram V4.5 Ideogram $0.011 /immagine -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine -
Ideogram V4 Ideogram $0.050 /immagine -
Seedream 4.5 ByteDance $0.045 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
FLUX.2 Black Forest Labs $0.035 /immagine -
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine -
Krea 3 Krea $0.036 /immagine -
Qwen Image 2.1 Alibaba $0.020 /immagine
Stesso fornitore
-
Wan 3.0 Video Alibaba $0.040 /secondo -
Qwen Image 2.0 Alibaba $0.042 /immagine -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caratteri -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
Z-Image Alibaba $0.008 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
Wan 2.6 Flash Alibaba $0.043 /secondo -
HappyHorse 1.0 Alibaba $0.168 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Wan 2.7 Video Alibaba $0.100 /secondo


