Ricontestualizzare le immagini prodotto

Anteprima

Questo prodotto o funzionalità è un'offerta di anteprima dell'AI generativa, soggetta ai "Termini delle offerte pre-GA" dei Termini specifici di servizio di Google Cloud, nonché ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. Per questa offerta di anteprima dell'IA generativa, i clienti possono scegliere di utilizzarla per scopi di produzione o commerciali o di divulgare l'output generato a terze parti e possono trattare i dati personali come descritto nell'Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le limitazioni all'interno dell'accordo che regola l'accesso a Google Cloud. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Il prodotto Imagen su Vertex AI ti consente di modificare le immagini prodotto in scene o sfondi diversi. Fornisci immagini di un prodotto e un prompt facoltativo e il prodotto Imagen ricontestualizza le immagini del tuo prodotto in nuove scene o sfondi.

Per richiedere l'accesso al prodotto di ricontestualizzazione di Imagen, compila il modulo Vertex AI - Generative Media for Marketing Access Request.

Tipi di prodotti supportati

Il recontext del prodotto Imagen supporta i seguenti tipi di prodotto:

• Appliance
• Commerciale e industriale
• Abbigliamento
• Elettronica
• Mobili
• Giardino e cortile
• Hardware
• Estetica e benessere
• Gioielleria
• Animali domestici
• Scarpe
• Articoli sportivi
• Giocattoli e giochi
• Veicoli

Esempio di ricontestualizzazione del prodotto

Di seguito è riportato un esempio di caso d'uso per la ricontestualizzazione dei prodotti:

Input di esempio	Output di esempio	Prompt utilizzato
		Su un banco di lavoro disordinato in un vicolo cyberpunk illuminato da luci al neon e pioggia, con pubblicità olografiche che sfarfallano sullo sfondo.
		Posizionata su una roccia ricoperta di muschio sul bordo di una scogliera, si affaccia su un'imponente e potente cascata in un drammatico paesaggio islandese nuvoloso.
		Seduto a un tavolino bianco di un caffè a Santorini, con una tazza di caffè, con vista sul Mar Egeo e sugli iconici edifici con cupole blu.

Prova la ricontestualizzazione del prodotto Imagen in un Colab

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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 (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 (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.

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

   Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

   gcloud init

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

   Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Generare immagini prodotto in diverse scene

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• REGION: la regione in cui si trova il progetto. Per ulteriori informazioni sulle regioni supportate, consulta AI generativa su località Vertex AI.
• PROJECT_ID: il tuo Google Cloud ID progetto.
• TEXT_PROMPT: (Facoltativo) Un prompt di testo per guidare le immagini generate dal modello.
• BASE64_SUBJECT_IMAGE: Un'immagine codificata in base64 dell'immagine del soggetto.
• PERSON_SETTING: (Facoltativo) Un valore stringa che controlla il tipo di persona o di volto che il modello consente di generare. Puoi utilizzare i seguenti valori per personGeneration:
  • "allow_adult": consente la generazione di soli adulti, ad eccezione della generazione di celebrità. La generazione di celebrità non è consentita per nessuna impostazione. Questa è l'impostazione predefinita.
  • "allow_all": consente la generazione di persone di tutte le età, ad eccezione delle celebrità. La generazione di celebrità non è consentita per nessuna impostazione.
  • "dont_allow": Non consente la generazione di persone o volti nell'output generato.
• SAFETY_SETTING: (facoltativo) Un valore stringa che controlla la soglia del filtro di sicurezza per le immagini generate. Puoi utilizzare i seguenti valori per selezionare l'impostazione di sicurezza:
  • "block_low_and_above": la soglia di sicurezza più rigorosa. "block_low_and_above" filtra il numero maggiore di immagini generate.
  • "block_medium_and_above": La soglia di sicurezza media, che bilancia il filtraggio dei contenuti potenzialmente dannosi e sicuri. "block_medium_and_above" è l'impostazione di sicurezza predefinita.
  • "block_only_high": La soglia di sicurezza più bassa, che riduce il numero di richieste bloccate a causa del filtro di sicurezza. L'utilizzo della soglia di sicurezza "block_only_high" potrebbe aumentare il numero di immagini discutibili generate dal modello.
• WATERMARK_SETTING: (Facoltativo) Un valore booleano. Quando questo valore è impostato su true, il modello aggiunge una filigrana digitale che puoi utilizzare per verificare l'immagine generata. Il valore predefinito è true.
• IMAGE_COUNT: il numero di immagini da generare. L'intervallo di valori accettato è 1-4.
• PROMPT_SETTING: (Facoltativo) Un valore booleano. Quando questo valore è impostato su true, il modello utilizza prmopt avanzati. Il valore predefinito è true.

Metodo HTTP e URL:

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/imagen-product-recontext-preview-06-30:predict

Corpo JSON della richiesta:

{
  "instances": [
    {
      "prompt": "TEXT_PROMPT",
      "productImages": [
        {
          "image": {
            "bytesBase64Encoded": "BASE64_SUBJECT_IMAGE"
          },
        }
      ]
    }
  ],
  "parameters": {
    "personGeneration": PERSON_SETTING,
    "safetySetting": SAFETY_SETTING,
    "addWatermark": WATERMARK_SETTING,
    "sampleCount": IMAGE_COUNT,
    "enhancePrompt": PROMPT_SETTING
  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, ed esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/imagen-product-recontext-preview-06-30:predict"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/imagen-product-recontext-preview-06-30:predict" | Select-Object -Expand Content

La richiesta restituisce oggetti immagine. In questo esempio, vengono restituiti due oggetti immagine, con due oggetti di previsione come immagini codificate in base64.

{
  "predictions": [
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    },
    {
      "bytesBase64Encoded": "BASE64_IMG_BYTES",
      "mimeType": "image/png"
    }
  ]
}