Qwen Image 3.0 Pro API

Qwen Image 3.0 Pro Modifica immagine modifica da una a tre immagini di riferimento seguendo un’istruzione. Con un riferimento è un intervento chirurgico: uno strillo di copertina, un capo, una luce. Con due o tre unisce, purché il prompt dica cosa porta ciascuna sorgente.

Qwen Image 3.0 Pro è il livello ad alto dettaglio della linea di immagini Qwen di Alibaba: prompt fino a 5.000 caratteri, otto formati, un livello 1K o 2K e modifica con da uno a tre riferimenti. Pensato per le immagini da consegnare, senza censura.

Scegli la modalità di Qwen Image 3.0 Pro in base al materiale di partenza

Composizione dell’immagine attenta al testo

Qwen Image 3.0 Pro è utile per concept visivi in cui testo fornito, composizione e trattamento dell’immagine vanno considerati insieme. Tratta le scritte generate come una bozza di design e rileggile prima della pubblicazione.

Comporre da zero e rivedere una sorgente sono lavori diversi

Usa il testo in immagine per costruire un visual da un brief scritto. Usa la modifica immagine quando un’immagine esistente fornisce identità, impaginazione o materiale da mantenere mentre si apporta una modifica precisa.

Controlla la gerarchia prima del dettaglio decorativo

Per poster, packaging e concept di campagna, decidi prima la gerarchia del messaggio e il punto focale. Un risultato gradevole manca comunque l’obiettivo se il testo approvato o i dati del prodotto non sono rappresentati correttamente.

Rifinire un’immagine fornita

Usa questa modalità quando da una a tre immagini approvate devono passare nel risultato. Elencale in image_urls nell’ordine in cui il prompt le cita e dai a ciascuna un ruolo — il volto dalla prima, il capo dalla seconda —, perché i ruoli non vengono mai dedotti.

Copertine di riviste ed editoriali senza censura

Tieni una copertina approvata e cambia un elemento per passaggio: uno strillo, un capo o la luce. Ristilizzare e riscrivere nella stessa chiamata è il punto in cui i volti derivano, quindi dividilo in due richieste.

Bozze di poster e affissioni

Prendi un poster approvato e sostituisci la riga della data o la dicitura legale per la prossima uscita. Cita la stringa vecchia e quella nuova, tieni aspect_ratio sulla forma dell’immagine e descrivi tutto il resto come invariato.

Bozze di packaging ed etichette

Invia un render del prodotto e cambiagli l’etichetta: cita il nome del marchio e il claim breve, di’ su quale superficie si trovano e usa negative_prompt contro i resti di lettere della vecchia etichetta.

# 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": "alibaba/qwen-image-3.0-pro/edit",
  "input": {
    "aspect_ratio": "1:1",
    "image_urls": [
      "https://example.com/reference.png"
    ],
    "num_outputs": 1,
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k"
  }
}'

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