Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
aspect_ratio | No | La forma dell'inquadratura: larga, quadrata o verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 · Predefinito: 1:1 |
background | No | Mantieni, rimuovi o sostituisci lo sfondo. opaque · transparent · Predefinito: opaque |
enable_prompt_expansion | No | Lascia che il modello arricchisca un prompt breve. Predefinito: true |
image_urls | Sì | Foto da modificare o combinare. Spiega nel prompt cosa aggiunge ciascuna. |
mask_url | No | Dipingi l'area da cambiare. |
output_format | No | Tipo di file del risultato. jpeg · png · webp · Predefinito: jpeg |
prompt | Sì | Describe the subject, composition, lighting, and any wording to render. |
resolution | No | Dimensione dell'output. Più grande è più nitido e costa di più. 1k · 1.5k · 2k · Predefinito: 1k |
seed | No | Lo stesso numero dà un risultato ripetibile. ≥ 0 · ≤ 2147483647 |
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 per immagine | ≈ USD |
|---|---|---|
| resolution 1K | 5,4 | 0,054 USD |
| resolution 2K | 7,2 | 0,072 USD |
| resolution 1.5K | 10,8 | 0,11 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 6 crediti per immagine (0,06 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 Qwen Image 2.1 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-image-2.1/edit 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-image-2.1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "1k",
"background": "opaque",
"output_format": "jpeg"
}
}'
# 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 Qwen Image 2.1
Quanto costa l’API di Qwen Image 2.1?
Qwen Image 2.1 costa da 6 crediti (0,06 USD) per immagine con Modifica immagine, il suo task più economico. Prezzi per opzione: 1K 5,4 crediti per immagine, 2K 7,2 crediti per immagine, 1.5K 10,8 crediti per immagine. 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 Qwen Image 2.1 nell’API?
Inserisci alibaba/qwen-image-2.1/text-to-image per Crea immagine; alibaba/qwen-image-2.1/edit per Modifica immagine nel campo model di POST /jobs/createTask.
È il modello che Alibaba ha appena reso open source?
Sì. Qwen-Image-2.1 è stato pubblicato a pesi aperti il 21 settembre 2026 ed è andato online qui lo stesso giorno, come API ospitata: nessuna installazione, nessuna GPU, nessun file di pesi da scaricare.
Posso modificare solo una parte dell'immagine invece di tutta l'inquadratura?
Sì, e l'abbiamo verificato. Segna la zona sull'immagine di riferimento — un cerchio tracciato o una macchia di colore — e descrivi la modifica al suo interno, chiedendo anche di rimuovere il segno. Nel nostro test la modifica è caduta esattamente dentro la zona segnata e il resto dell'inquadratura è rimasto intatto.
Quante immagini di riferimento accetta la modifica?
Da una a dieci. Dichiara nel prompt che cosa porta ciascuna, perché il modello non assegna i ruoli da solo. Ogni riferimento in più alza il preventivo, quindi manda solo quelli che servono davvero.
Un seed fisso riproduce la stessa immagine?
No. Abbiamo inviato due volte lo stesso prompt con lo stesso seed e ottenuto due inquadrature diverse. Usa il seed per tenere coerente il carattere di una serie e conserva l'asset restituito quando ti serve di nuovo quell'immagine esatta.
Esiste un negative prompt?
Non in questa famiglia. Metti le esclusioni nel prompt principale: ha 5.000 caratteri, spazio più che sufficiente per dire sia che cosa deve entrare nell'inquadratura sia che cosa no.
Quali sono i limiti dell’API di Qwen Image 2.1?
Risoluzioni: 1K · 1.5K · 2K; Proporzioni: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Immagini di riferimento: 10; Lunghezza del prompt (caratteri): 5,000; Caricamento massimo: 10 MB. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Qwen Image 2.1 senza scrivere codice?
Sì. Il Playground esegue Qwen Image 2.1 con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.
Tutti i modelli Qwen Image
Qwen Image 2.1 Turbo è più veloce ed economico per le bozze, e Pro aggiunge più dettaglio nei ritratti. Il modello standard sta nel mezzo, con modifiche a maschera e ritagli trasparenti.
- API di Qwen Image 2.1 ProFino a sei immagini 2K dettagliate da un solo promptDa 6 crediti per immagine
- API di Qwen Image 2.1 TurboRender veloci in 8 passaggi, fino a sei per promptDa 3 crediti per immagine
- API di Qwen Image 2.1Modello aperto con output 2K e sfondi trasparentiDa 4 crediti per immagine
- API di Qwen Image 2.1 LoRAImmagini e modifiche Qwen Image 2.1 con fino a tre tue LoRADa 5 crediti per immagine
- API di Qwen Image 3.0 ProTipografia curata e pelle, tessuti e vetro realisticiDa 6 crediti per immagine
- API di Qwen Image 3.0Insegne e titoli leggibili disegnati nell’immagineDa 5 crediti per immagine
- API di Qwen Image 2Immagini da testo semplici e modifiche su una sola fotoDa 6 crediti per immagine
- API di Qwen Image 2512 LoRARender e modifiche Qwen Image 2512 con le tue LoRADa 5 crediti per immagine
- API di Qwen Image Edit 2509 LoRAModifiche Qwen su più foto che caricano le tue LoRADa 5 crediti per immagine
- API di Qwen Image 1.0 LoRAIl Qwen-Image originale, scritte pulite e le tue LoRADa 5 crediti per immagine

