qwen_image_edit_spicy

Modifica immagini. ID pubblico: qwen_image_edit_spicy; prezzo base: $0.040 per immagine riuscita. In APIMaster usare questo ID con trattini bassi.

Usare una chiave API APIMaster con Authorization: Bearer. JSON: Content-Type: application/json; per multipart lasciare che cURL/requests imposti il boundary. https://apimaster.ai/v1 include già /v1.

POST https://apimaster.ai/v1/images/generations · application/json

Gli esempi sono sincroni: il server attende e interroga il processo già accettato. Il client riceve il risultato Images finale, non l’UUID del fornitore. Timeout di lettura ampio, ad esempio 750 secondi; nessuno streaming.

Parametri

Campo / tipo	Regole e valori predefiniti
model · string	Obbligatorio: ID pubblico esatto riportato sopra.
prompt · string	Stringa obbligatoria non vuota con descrizione o istruzione di modifica.
n · integer = 1	Intero facoltativo: solo 1, predefinito 1.
response_format · string = url	Stringa facoltativa: url (predefinita) o b64_json.
image · string	Immagine principale obbligatoria: URL accessibile o URI dati (data:image/png;base64,...).
reference_images · string[] | null = null; []	Array facoltativo di stringhe, massimo due riferimenti aggiuntivi in formato URL/URI dati. Massimo tre immagini totali, principale inclusa.
images / image_urls · string[]	Array ordinato alternativo: prima immagine principale, poi al massimo due riferimenti. Usare una sola convenzione per evitare duplicati.
seed · integer | null = null	Intero facoltativo o null, predefinito null; 0 o null usa un seme casuale. Nessun intervallo documentato; non applicare quello di Z Image.
size · string = auto	Facoltativo: solo auto. Dimensioni determinate dall’immagine principale; non inviare width/height.
quality · standard; stream · false	Non supportati: n>1, stream=true, mask/mask_url, style, background, output_format e watermark. Omettere quality o usare standard, senza livello aggiuntivo. Parametri extra sconosciuti rifiutati.
resolution	Qwen richiede una principale e al massimo due riferimenti. JSON unisce image, images, image_urls, reference_images in quest’ordine; preferire solo image e reference_images. Vietati prompt_extend e dimensioni esplicite; omettere resolution.

Esempi

cURL · JSON

curl --max-time 750 'https://apimaster.ai/v1/images/generations' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "qwen_image_edit_spicy",
  "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "image": "https://example.com/primary.png",
  "reference_images": [
    "https://example.com/reference.png"
  ]
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "qwen_image_edit_spicy",
    "prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "image": "https://example.com/primary.png",
    "reference_images": [
        "https://example.com/reference.png"
    ]
}
response = requests.post(
    api_base + "/images/generations",
    headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
    json=payload,
    timeout=(20, 750),
)
response.raise_for_status()
result = response.json()
print(result)

cURL · multipart

Multipart /images/edits: file tramite image, image[] ripetuto o images. Ogni file deve essere un’immagine da 1 byte a 10 MiB; il primo è principale. Usare un unico campo. reference_images multipart è un array JSON di stringhe URL/URI dati.

curl --max-time 750 'https://apimaster.ai/v1/images/edits' \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -F 'model=qwen_image_edit_spicy' \
  -F 'prompt=Change the red paper boat to blue.' \
  -F 'n=1' \
  -F 'response_format=b64_json' \
  -F 'seed=0' \
  -F 'image[]=@primary.png' \
  -F 'image[]=@reference.png'

Risposte e fatturazione

HTTP 200 contiene created (secondi Unix) e un solo elemento data. url è l’indirizzo scaricabile; salvare subito l’immagine. b64_json contiene byte base64. Verificare anche il contenuto.

{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}

{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}

Prezzi base per immagine; i moltiplicatori esistenti di canale, gruppo e account determinano l’addebito finale nel marketplace e nei log. Dimensioni e riferimenti supportati non hanno supplementi separati; n=1.

qwen_image_edit_spicy

Limiti e risoluzione dei problemi

Non supportati: n>1, stream=true, mask/mask_url, style, background, output_format e watermark. Omettere quality o usare standard, senza livello aggiuntivo. Parametri extra sconosciuti rifiutati.

Qwen richiede una principale e al massimo due riferimenti. JSON unisce image, images, image_urls, reference_images in quest’ordine; preferire solo image e reference_images. Vietati prompt_extend e dimensioni esplicite; omettere resolution.

Correggere i parametri dopo 400. Rifiuti e guasti del fornitore producono errori. Timeout, disconnessione o ricevuta sconosciuta non provano un rifiuto: conservare l’ID, controllare log o assistenza prima di un altro POST a pagamento. Nessun reinvio automatico di processi accettati.

---

Panoramica API immagini · z-image-spicy-pro

Specifica verificata il 2026-10-30. Il contratto descrive l’adattatore APIMaster distribuito, non l’API diretta del fornitore.

MuleRouter API