Genera e modifica immagini su Vertex AI

Panoramica del riferimento API: per visualizzare una panoramica delle opzioni API per la generazione e la modifica delle immagini, consulta il imagegenerationriferimento API del modello.

Gemini e Imagen su Vertex AI offrono agli sviluppatori di applicazioni le funzionalità di AI generativa di Google all'avanguardia per le immagini. Con Gemini e Imagen su Vertex AI, gli sviluppatori di applicazioni possono creare prodotti AI di nuova generazione che trasformano l'immaginazione degli utenti in asset visivi di alta qualità in pochi secondi con l'AI generativa.

Prova la generazione di immagini (Vertex AI Studio)

Provare Imagen in Colab

Con Gemini e Imagen puoi:

• Genera nuove immagini utilizzando solo un prompt di testo (generazione di immagini con l'AI da testo a immagine).
• Modifica o espandi un'immagine caricata o generata utilizzando un'area della maschera che definisci.
• Migliora la risoluzione delle immagini esistenti, generate o modificate.

• 
• 
• 
• 
• 
• 

Prompt per le immagini precedenti

Queste immagini vengono generate utilizzando il modello di generazione di immagini generale Imagen 3 (imagen-3.0-generate-002) e i seguenti prompt:

1. Scena in claymation. Inquadratura media di una donna anziana. Indossa abiti ampi. Si trova in un giardino lussureggiante e annaffia le piante con un annaffiatoio arancione
2. Scattata in stile fotocamera DSLR con il filtro polarizzatore. Una foto di due mongolfiere sopra le formazioni rocciose uniche della Cappadocia, in Turchia. I colori e i motivi di queste mongolfiere contrastano splendidamente con i toni della terra del paesaggio sottostante. Questa inquadratura cattura il senso di avventura che si prova quando si vive un'esperienza del genere.
3. Un robot mech di legno invecchiato ricoperto di viti in fiore si trova tranquillamente in un campo di fiori selvatici alti, con un piccolo uccello blu appoggiato sulla mano tesa. Cartone animato digitale, con colori caldi e linee morbide. Dietro si erge una grande scogliera con una cascata.
4. Una mano che tiene una piccola statuetta di argilla a forma di uccello e la modella con uno strumento di modellazione nell'altra mano. Puoi vedere la sciarpa dello scultore. Le mani sono coperte di polvere di argilla. Un'immagine macro di una DSLR che mette in evidenza la trama e la lavorazione.
5. Un grande bouquet di fiori colorati in un vecchio vaso di vetro blu sul tavolo. Davanti c'è un bellissimo fiore di peonia circondato da vari altri fiori come rose, gigli, margherite, orchidee, frutta, bacche e foglie verdi. Lo sfondo è grigio scuro. Pittura a olio nello stile del Secolo d'oro olandese.
6. Un'unica vignetta di un fumetto che mostra un ragazzo e suo padre su una collina erbosa, che guardano il tramonto. Un fumetto esce dalla bocca del ragazzo e dice: Il sole sorgerà di nuovo. Stile di colorazione tenue di fine anni '90

Guida rapida: genera immagini da prompt di testo utilizzando Imagen

Puoi generare nuove immagini utilizzando solo testo descrittivo come input. Gli esempi seguenti mostrano un caso semplificato per la generazione di immagini, ma puoi utilizzare parametri aggiuntivi per adattare le immagini generate alle tue esigenze.

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Configura l'autenticazione per il tuo ambiente.

   Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

   Python

   Per utilizzare gli esempi di Python in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

   1. Installa Google Cloud CLI.

   2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

   3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente:

      gcloud auth application-default login

      Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

      Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

   Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud .

   REST

   Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

   Installa Google Cloud CLI.

   Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

   Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

2. Utilizza i seguenti esempi per generare un'immagine:

   Python

   from google import genai
   from google.genai.types import GenerateImagesConfig
   
   client = genai.Client()
   
   # TODO(developer): Update and un-comment below line
   # output_file = "output-image.png"
   
   image = client.models.generate_images(
       model="imagen-4.0-generate-001",
       prompt="A dog reading a newspaper",
       config=GenerateImagesConfig(
           image_size="2K",
       ),
   )
   
   image.generated_images[0].image.save(output_file)
   
   print(f"Created output image using {len(image.generated_images[0].image.image_bytes)} bytes")
   # Example response:
   # Created output image using 1234567 bytes
   

   REST

   1. Imposta le variabili di ambiente:

      export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT # Replace with your Google Cloud project
      export GOOGLE_CLOUD_LOCATION=us-central1 # Replace with the appropriate location for your project
                  

   2. Esegui questo comando:

      curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json; charset=utf-8" \
      "https://${GOOGLE_CLOUD_LOCATION}-aiplatform.googleapis.com/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/${GOOGLE_CLOUD_LOCATION}/publishers/google/models/imagen-4.0-generate-preview-05-20:predict" -d \
      $'{
        "instances": [
          {
            "prompt": "a cat reading a book"
          }
        ],
        "parameters": {
          "sampleCount": 1
        }
      }'
                  

      Il modello restituisce un oggetto byte immagine base64.

   Per saperne di più, consulta l'API Genera immagini di Imagen.

Quando utilizzare Gemini o Imagen su Vertex AI

Oltre a utilizzare le funzionalità di generazione di immagini integrate di Gemini, puoi accedere anche a Imagen, il nostro modello specializzato di generazione di immagini.

Attributo	Immagine di Gemini	Imagen 4
Punti di forza	Suggerimento predefinito. Flessibilità senza pari, comprensione contestuale e modifica senza maschere. Capacità unica di editing conversazionale in più passaggi.	Migliore qualità/latenza
Disponibilità	Disponibilità generale	Disponibilità generale
Latenza	Maggiore. Per le sue funzionalità avanzate è necessario un maggiore calcolo.	Basso. Ottimizzazione per prestazioni quasi in tempo reale.
Costo	Prezzi basati sui token.	Conveniente per attività specializzate.
Attività consigliate	Generazione di testo e immagini con interleaving per combinare perfettamente testo e immagini. Combina elementi creativi di più immagini con un unico prompt. Apporta modifiche molto specifiche alle immagini, modifica singoli elementi con comandi vocali e lavora in modo iterativo su un'immagine. Applica un design o una texture specifici da un'immagine a un'altra preservando la forma e i dettagli del soggetto originale.	Qualità dell'immagine, fotorealismo, dettagli artistici o stili specifici (ad esempio impressionismo e anime) sono le priorità principali. Incorporare il branding, lo stile o generare loghi e design dei prodotti. Generare ortografia o tipografia avanzata.

Ti consigliamo di utilizzare Gemini come punto di partenza per generare immagini. Scegli Imagen 4 Ultra per casi d'uso avanzati o quando hai bisogno della migliore qualità dell'immagine.

Versioni modello

Esistono diversi modelli di generazione di immagini che puoi utilizzare. Per saperne di più, consulta Modelli Gemini o Modelli Imagen.

Prova altri esempi

Per saperne di più, esegui i seguenti blocchi note nell'ambiente che preferisci:

• "Generazione di immagini con Gemini 3 Pro in Vertex AI":

  Apri in Colab | Apri in Colab Enterprise | Apri in Vertex AI Workbench | Visualizza su GitHub

• "Generazione di immagini Gemini 2.5 Flash in Vertex AI":

  Apri in Colab | Apri in Colab Enterprise | Apri in Vertex AI Workbench | Visualizza su GitHub

• "Generazione di immagini con Imagen 4":

  Apri in Colab | Apri in Colab Enterprise | Apri in Vertex AI Workbench | Visualizza su GitHub

• "Imagen 3 Image Editing":

  Apri in Colab | Apri in Colab Enterprise | Apri in Vertex AI Workbench | Visualizza su GitHub

Per un elenco completo di tutorial sui notebook Jupyter che utilizzano Imagen, consulta il cookbook sull'AI generativa su Vertex AI.

Passaggi successivi

Utilizza i seguenti link per visualizzare la documentazione della funzionalità.

Guida ai prompt

Scopri come scrivere prompt efficaci per generare immagini.

Istruzioni: genera immagini

Scopri come generare immagini con Imagen su Vertex AI.

Riferimento: genera immagini

Scopri di più sui campi facoltativi e obbligatori quando invii una richiesta di generazione di immagini con Imagen.

Crediti immagine: tutte le immagini generate utilizzando Imagen su Vertex AI.