API Qwen Qwen Image 2.1 T2I | Prezzi e documentazione

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

Qwen Image 2.1 T2I trasforma i prompt testuali in immagini ferme 1K o 2K con controllo del rapporto d'aspetto, trasparenza nativa, riscrittura del prompt e blocco del seme.

Indice

1. Per iniziare

Usa l'API RunComfy per eseguire qwen/qwen-image-2.1/text-to-image. Per input e output accettati, consulta lo schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

2. Autenticazione

Imposta la variabile d'ambiente YOUR_API_TOKEN con la tua chiave API (gestione nel Profilo) e includi in ogni richiesta un token Bearer nell'intestazione Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. File in ingresso

File ospitato (URL)

Fornisci un URL HTTPS raggiungibile pubblicamente. L'host deve consentire fetch lato server (senza login/cookie), senza rate limit eccessivo o blocco bot. Consigliato: immagini ≤ 50 MB (~4K), video ≤ 100 MB (~2–5 min a 720p). Per asset privati, URL stabili o pre-firmati.

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Descrivi il soggetto, l'ambientazione, lo stile e qualsiasi testo esatto che desideri venga reso. Metti le parole tra virgolette per renderle letteralmente.",
      "type": "string",
      "default": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
    },
    "aspect_ratio": {
      "title": "Formato (L:A)",
      "description": "Rapporto di aspetto dell'output. La dimensione dei pixel dipende anche dal livello di risoluzione.",
      "type": "string",
      "enum": [
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "1:1"
    },
    "resolution": {
      "title": "Risoluzione",
      "description": "Livello di dettaglio dell'output. 1K è più veloce; 2K ha circa quattro volte i pixel e costa di più.",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "Sfondo",
      "description": "opaco per una foto normale. trasparente scrive un vero canale alfa — descrivi solo il soggetto e non usare JPEG.",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "Formato di output",
      "description": "PNG e WebP possono avere un canale alfa. JPEG non può, quindi non può essere combinato con uno sfondo trasparente.",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "Migliora il prompt",
      "description": "Riscrivi un breve prompt in una scena più completa prima di generare. Disattiva quando il tuo prompt è già preciso.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Semi casuale per la riproducibilità. Usa -1 per un seme casuale a ogni esecuzione.",
      "type": "integer",
      "default": -1
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy è la piattaforma principale ComfyUI che offre ComfyUI online ambiente e servizi, insieme a workflow di ComfyUI con visuali mozzafiato. RunComfy offre anche AI Models, consentire agli artisti di sfruttare gli ultimi strumenti di AI per creare arte incredibile.

1. Per iniziare

Usa l'API RunComfy per eseguire qwen/qwen-image-2.1/text-to-image. Per input e output accettati, consulta lo schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

3. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-2.1/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
  }'

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Descrivi il soggetto, l'ambientazione, lo stile e qualsiasi testo esatto che desideri venga reso. Metti le parole tra virgolette per renderle letteralmente.",
      "type": "string",
      "default": "A linen tote on a sunlit marble ledge, oversized navy serif type reading \"HARBOR LINEN\", a small caption \"Washed canvas · Est. 2012\", soft contact shadow, catalog still, no extra logos."
    },
    "aspect_ratio": {
      "title": "Formato (L:A)",
      "description": "Rapporto di aspetto dell'output. La dimensione dei pixel dipende anche dal livello di risoluzione.",
      "type": "string",
      "enum": [
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "1:1"
    },
    "resolution": {
      "title": "Risoluzione",
      "description": "Livello di dettaglio dell'output. 1K è più veloce; 2K ha circa quattro volte i pixel e costa di più.",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "Sfondo",
      "description": "opaco per una foto normale. trasparente scrive un vero canale alfa — descrivi solo il soggetto e non usare JPEG.",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "Formato di output",
      "description": "PNG e WebP possono avere un canale alfa. JPEG non può, quindi non può essere combinato con uno sfondo trasparente.",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "Migliora il prompt",
      "description": "Riscrivi un breve prompt in una scena più completa prima di generare. Disattiva quando il tuo prompt è già preciso.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Semi casuale per la riproducibilità. Usa -1 per un seme casuale a ogni esecuzione.",
      "type": "integer",
      "default": -1
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Qwen Image 2.1 T2I: Testo-in-immagine con trasparenza su Models and API | RunComfy

Qwen Image 2.1 T2I trasforma i prompt testuali in immagini ferme 1K o 2K con controllo del rapporto d'aspetto, trasparenza nativa, riscrittura del prompt e blocco del seme.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output

Qwen Image 2.1 T2I: Testo-in-immagine con trasparenza su Models and API | RunComfy

Qwen Image 2.1 T2I trasforma i prompt testuali in immagini ferme 1K o 2K con controllo del rapporto d'aspetto, trasparenza nativa, riscrittura del prompt e blocco del seme.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output