Riferimento API di Qwen Image 2.1

Con una sola chiave API di PopNow chiami Qwen Image 2.1 dal tuo codice. Qui trovi gli ID del modello da inviare, ogni campo di input accettato, quanti crediti costa ogni richiesta e una richiesta da incollare nel terminale così com’è.

Le descrizioni dei parametri provengono dallo schema di input del modello e sono disponibili solo in inglese.

In sintesi

Sviluppato da: Alibaba
Risultato: Immagine
Da: 3.6 crediti per immagine ($0.036)
Tempo tipico: circa 44 s
ID del modello: alibaba/qwen-image-2.1/text-to-image
alibaba/qwen-image-2.1/edit

1 credito = 0,01 $. All’accettazione l’attività trattiene l’importo massimo possibile e alla fine addebita il consumo reale, arrotondato al credito superiore; il resto viene sbloccato. Le attività non riuscite non vengono addebitate. Per conoscere la cifra esatta prima di eseguire, chiama POST /api/v1/jobs/quote.

Crea immagine

alibaba/qwen-image-2.1/text-to-image

Prezzo

Opzione	Crediti (per immagine)	Dollari USA
`1k`	3.6	$0.036
`1.5k`	7.2	$0.072
`2k`	7.2	$0.072

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 5000 caratteri	Describe the subject, composition, lighting, and any wording to render.
`aspect_ratio`Facoltativo	`string`	`1:1`	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, … (+1)	Output aspect ratio.
`resolution`Facoltativo	`string`	`1k`	1k, 1.5k, 2k	Output resolution tier.
`enable_prompt_expansion`Facoltativo	`boolean`	`true`	—	Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word.
`background`Facoltativo	`string`	`opaque`	opaque, transparent	opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp).
`output_format`Facoltativo	`string`	`jpeg`	jpeg, png, webp	Container of the returned image.
`seed`Facoltativo	`integer`	—	da 0 a 2147483647	Random seed for controlled comparisons.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "alibaba/qwen-image-2.1/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "1k"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Modifica immagine

alibaba/qwen-image-2.1/edit

Prezzo

Opzione	Crediti (per immagine)	Dollari USA
`1k`	5.4	$0.054
`2k`	7.2	$0.072
`1.5k`	10.8	$0.108

Parametri

Campo	Tipo	Predefinito	Valori ammessi	A cosa serve
`prompt`Obbligatorio	`string`	—	fino a 5000 caratteri	Describe the subject, composition, lighting, and any wording to render.
`image_urls`Obbligatorio	`array<string (uri)>`	—	fino a 10 elementi	One to ten reference images. Each one you add raises the quote.
`mask_url`Facoltativo	`string (uri)`	—	—	Optional black-and-white mask for local editing: white is the area to repaint, black is kept. Use it with exactly one reference image.
`aspect_ratio`Facoltativo	`string`	`1:1`	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, … (+1)	Output aspect ratio.
`resolution`Facoltativo	`string`	`1k`	1k, 1.5k, 2k	Output resolution tier.
`enable_prompt_expansion`Facoltativo	`boolean`	`true`	—	Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word.
`background`Facoltativo	`string`	`opaque`	opaque, transparent	opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp).
`output_format`Facoltativo	`string`	`jpeg`	jpeg, png, webp	Container of the returned image.
`seed`Facoltativo	`integer`	—	da 0 a 2147483647	Random seed for controlled comparisons.

Richiesta di esempio

Questa richiesta funziona così com’è; i campi omessi usano il valore predefinito. Prima salva la tua chiave in POPNOW_API_KEY.

L’esempio usa file di prova di PopNow in image_urls. Sostituiscili con i tuoi link HTTPS pubblici, file caricati o asset salvati.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/qwen-image-2.1/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "1k"
  }
}'

La risposta contiene subito un taskId. Recupera il risultato con GET /api/v1/jobs/recordInfo, oppure aggiungi callBackUrl per ricevere una notifica.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Riferimento API di Qwen Image 2.1

In sintesi

Crea immagine

Prezzo

Parametri

Richiesta di esempio

Modifica immagine

Prezzo

Parametri

Richiesta di esempio

Passi successivi

In questa pagina