Alibaba

Qwen Image 3.0

qwen-image-3.0-pro/image-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

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

Prova qwen-image-3.0-pro/image-to-image

Input

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

qwen-image-3.0-pro/image-to-image per image

Specifiche	Prezzo unitario
1K	$0.0497
2K	$0.0993

Panoramica della posizione

La linea di editing delle immagini di Qwen Image 3.0 Pro consente modifiche controllate all'immagine basate su 1–3 immagini di riferimento, con l'obiettivo di preservare i dettagli chiave dell'originale mentre si sostituiscono scene, stili, abbigliamento o testo nell'immagine. È adatta a team di design, e-commerce e content che necessitano di iterare ripetutamente sullo stesso materiale; tramite l'interfaccia unificata di HiAPI.ai, basta descrivere nel prompt cosa mantenere e cosa modificare per ottenere l'immagine finale, ideale per trasformare asset visivi esistenti in materiali multi-versione.

Punti di forza principali

Iterazione su immagini di riferimento anziché ridisegno — utilizza 1–3 immagini di riferimento come base di input e modifica i contenuti specificati preservando i dettagli chiave dell'originale.
Orientata a immagini informative — il prompt può descrivere contenuti densi come layout, elementi e testo, producendo risultati più vicini ai deliverable lavorativi reali.
Specifiche di output controllabili — livello di risoluzione, rapporto d'aspetto, formato di output e seed casuale sono tutti specificabili, facilitando la produzione in batch di materiali con specifiche uniformi.

Descrizione delle capacità

Editing con più immagini di riferimento: accetta 1–3 immagini di riferimento, supporta formati comuni come JPEG, PNG, WEBP, BMP, GIF, TIFF, con dimensione massima di 10 MB per immagine; utilizzabile per modifiche mirate di scena, stile e abbigliamento.

Descrizione delle modifiche tramite prompt lunghi: il prompt positivo può raggiungere i 18000 caratteri, consentendo di specificare separatamente le parti da mantenere e quelle da cambiare; il prompt negativo controlla separatamente i contenuti indesiderati.

Regolazione di layout e testo: per immagini con molti elementi, consente di regolare layout e contenuti testuali durante l'editing, adatta a trasformare poster, mockup di interfaccia e immagini prodotto esistenti in nuove versioni.

Controllo delle specifiche di output: risoluzione selezionabile tra 1K e 2K, otto rapporti d'aspetto e formati di output png o jpeg, con supporto per la riproduzione dei risultati tramite seed fisso.

Ottimizzazione automatica del prompt: l'espansione del prompt è attiva per impostazione predefinita e può integrare dettagli descrittivi quando il prompt è breve; può essere disattivata per eseguire esattamente il testo originale.

Scenari d'uso

Team di design che revisionano poster e banner — inserendo l'immagine di layout esistente e le istruzioni di modifica si ottiene una nuova versione con proporzioni e testi aggiornati, pronta per la pubblicazione e la sostituzione dei materiali.
Operatori e-commerce che trasformano le immagini prodotto — utilizzando l'immagine prodotto esistente come riferimento, si sostituiscono sfondo, scena o abbigliamento del modello, producendo più set di immagini per pagine dettaglio e pagine promozionali.
Iterazione di concept UI — inserendo schizzi di interfaccia o mockup esistenti, si modificano layout e presentazione dei controlli secondo il prompt, ottenendo prototipi ad alta fedeltà per la discussione delle soluzioni.
Localizzazione di materiali multilingue — partendo dalla stessa immagine originale si sostituiscono testi e lingua, producendo in batch versioni per mercati diversi da utilizzare nella pubblicità localizzata.

Limiti e consigli di selezione

Le immagini di riferimento sono al massimo 3, il che limita gli scenari di composizione complessa con più immagini; l'input SVG non è supportato e ogni immagine di riferimento non deve superare i 10 MB. La leggibilità di layout e testo dipende dalla densità tipografica e dalla lingua; i testi piccoli e densi richiedono comunque una verifica a campione. Questa linea esegue solo image-to-image: se serve generare un'immagine solo dal testo, occorre passare alla linea text-to-image della stessa serie; per attività in batch che richiedono elevata stabilità dei risultati si consiglia di fissare il seed e conservare la versione del prompt per la riproduzione.

Novità

Vedi il changelog →

Nuovo modello Nuovo modello disponibile: qwen-image-3.0-pro/text-to-image Oct 31, 2026
Nuovo modello Lancio del modello image-to-image qwen-image-3.0-pro Oct 31, 2026
Nuovo modello Aggiunti qwen-image-3.0/text-to-image… Aug 20, 2026

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

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: qwen-image-3.0-pro/image-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per qwen-image-3.0-pro/image-to-image e la route default — vedi la tabella dei parametri sotto.

seedintegerOpzionalemin 0max 2147483647

Seme casuale, utilizzato per controllare la casualità dei risultati di generazione; con lo stesso seme e gli altri parametri identici è possibile riprodurre risultati di immagine simili.

promptstringObbligatoriominLength 1maxLength 18000

Prompt positivo, descrive il contenuto dell'immagine che si desidera mantenere e quello che deve essere modificato; è l'input di guida principale per la generazione immagine-da-immagine.

image_urlsarrayObbligatoriominItems 1maxItems 3

Array di URL delle immagini di riferimento, controlla le immagini di input su cui si basa la generazione immagine-da-immagine; è necessario fornire 1–3 immagini, nei formati JPEG, PNG, WEBP, BMP, GIF, TIFF, ciascuna non superiore a 10 MB, SVG non supportato.

Array [ string ]

resolutionstringOpzionalePredefinito: "1K"

Livello di risoluzione dell'output, controlla il livello di nitidezza dell'immagine generata; predefinito 1K.

Opzioni:1K2K

aspect_ratiostringOpzionalePredefinito: "1:1"

Rapporto larghezza-altezza dell'immagine di output, controlla le dimensioni di composizione dell'immagine generata; predefinito 1:1.

Opzioni:1:13:22:34:33:416:99:1621:9

output_formatstringOpzionalePredefinito: "png"

Formato file dell'immagine generata, controlla il tipo di file del risultato restituito; predefinito png.

Opzioni:pngjpeg

prompt_extendbooleanOpzionalePredefinito: true

Indica se ottimizzare automaticamente il prompt; se attivato, il modello espande e rifinisce il prompt di input; predefinito true.

negative_promptstringOpzionalePredefinito: ""maxLength 500

Prompt negativo, descrive il contenuto che non si desidera compaia nell'immagine; predefinito stringa vuota.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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-pro/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "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-pro/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "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-pro/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}