logo
RunComfy
  • ComfyUI
  • TrainerNuovo
  • Modelli
  • API
  • Prezzi
discord logo
MODELLI
Esplora
Tutti i modelli
LIBRERIA
Generazioni
API DEI MODELLI
Documentazione API
Chiavi API
ACCOUNT
Utilizzo

Gemini 3 Pro Text-to-Image: Generazione di immagini configurabile | RunComfy

google/gemini-3-pro-image-preview/text-to-image

Genera da 1 a 4 immagini da un prompt obbligatorio, con 10 rapporti d’aspetto, risoluzione 1K, 2K o 4K, tre formati di file e restituzione sincrona facoltativa.

Indice

1. Per iniziare2. Autenticazione3. Riferimento APIInvia una richiestaStato della richiestaRecupera i risultatiAnnulla richiesta4. File in ingressoFile ospitato (URL)5. SchemaSchema di inputSchema di output

1. Per iniziare

Usa l'API RunComfy per eseguire google/gemini-3-pro-image-preview/text-to-image. Per input e output accettati, consulta lo schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

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/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

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": "Descrizione testuale dell'immagine o delle immagini da generare.",
      "type": "string",
      "default": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
    },
    "aspect_ratio": {
      "title": "Proporzioni (L:A)",
      "description": "Proporzioni delle immagini generate. Scegli uno dei 10 valori elencati.",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Risoluzione",
      "description": "Risoluzione di uscita. Valori consentiti: `1K`, `2K` e `4K`.",
      "type": "string",
      "enum": [
        "1K",
        "2K",
        "4K"
      ],
      "default": "1K"
    },
    "output_format": {
      "title": "Formato di output",
      "description": "Formato immagine in uscita. Valori consentiti: `jpeg`, `png` e `webp`; predefinito: `png`.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "num_images": {
      "title": "Numero di immagini",
      "description": "Numero di immagini da generare. Intervallo consentito: da 1 a 4; predefinito: 1.",
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 4
    },
    "sync_mode": {
      "title": "Modalità sincrona",
      "description": "Quando `true`, il supporto viene restituito come URI di dati e i relativi dati di output non vengono archiviati nella cronologia delle richieste. Il valore predefinito è `false`.",
      "type": "boolean",
      "default": false
    }
  }
}

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"
        }
      }
    }
  }
}
Seguici
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Supporto
  • Discord
  • Email
  • Stato del Sistema
  • affiliato
Modelli Video
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • Visualizza tutti i modelli →
Modelli Immagine
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Visualizza tutti i modelli →
Legale
  • Termini di Servizio
  • Informativa sulla Privacy
  • Informativa sui Cookie
RunComfy
Copyright 2026 RunComfy. Tutti i Diritti Riservati.

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.