Qwen Image 3.0 API

Qwen Image 3.0 Modifica immagine riceve da una a tre immagini di riferimento e un’istruzione e restituisce un risultato modificato. Con un solo riferimento è una modifica mirata; con due o tre unisce — un volto da una, un capo o uno sfondo da un’altra — purché il prompt dica quale immagine fornisce cosa.

Qwen Image 3.0 è il modello di immagini di Alibaba specializzato nella resa del testo: prompt fino a 5.000 caratteri, otto formati, un livello 1K o 2K e un endpoint di modifica che legge da uno a tre riferimenti. Senza censura, senza etichette da impostare.

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

Composizione dell’immagine attenta al testo

Qwen Image 3.0 è 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 esistenti devono fissare soggetto, impaginazione o materiale. Elencale in image_urls nell’ordine in cui il tuo prompt le cita — prima, seconda, terza — e di’ cosa fornisce ciascuna.

Set di personaggi e serie moda

Tieni il personaggio di un’immagine approvata e cambia un dettaglio per richiesta: guardaroba, luce o posa. Fissa seed quando confronti due formulazioni della stessa modifica, così non è l’estrazione a fare la differenza.

Varianti con testo localizzato

Invia l’immagine approvata all’endpoint di modifica e cambia solo le parole dell’insegna. Posa, guardaroba, luce e color grading sono descritti come invariati, quindi la variante differisce nel testo e non nell’intera immagine.

Ambientazioni per hotellerie e allestimenti

Invia un’immagine approvata di una camera o di un bar e aggiungi o sostituisci la segnaletica: un cartellino per la porta, una lavagna del menu, una scritta al neon. Cita il nuovo testo e, se un’insegna esiste già, cita anche la stringa precedente.

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