Omettere contenuti utilizzando un prompt negativo

Prova Imagen in un Colab

Questa pagina descrive come omettere i contenuti dalle immagini generate da Imagen su Vertex AI.

Un prompt negativo è una descrizione di ciò che vuoi omettere nelle immagini generate. Ad esempio, considera il prompt "una strada di città piovosa di notte senza persone". Il modello potrebbe interpretare "persone" come una direttiva di cosa includere anziché omettere. Per generare risultati migliori, puoi utilizzare il prompt "una strada di città piovosa di notte" con un prompt negativo "persone".

Imagen genera queste immagini con e senza un prompt negativo:

Solo prompt testuale

  • Prompt testuale: "una pizza"

tre immagini di esempio di pizza

Prompt testuale e prompt negativo

  • Prompt testuale: "una pizza"
  • Prompt negativo: "salame piccante"

tre immagini di esempio di pizza senza salame piccante

I seguenti modelli supportano i prompt negativi:

Utilizzare un prompt negativo

Per omettere i contenuti dalle immagini generate:

Console

  1. Nella Google Cloud console, vai alla pagina Vertex AI > Media Studio.

    Vai a Media Studio

  2. Fai clic su Imagen. Viene visualizzata la pagina di generazione di immagini di Imagen Media Studio.

  3. Nel riquadro Impostazioni, regola le seguenti opzioni:

    • Modello: scegli un modello tra le opzioni disponibili.

      Per ulteriori informazioni sui modelli disponibili, consulta Modelli Imagen

    • Numero di risultati: regola il cursore o inserisci un valore compreso tra 1 e 4.

    • Nella casella Prompt negativo, inserisci un prompt che descriva ciò che non vuoi generare nell'immagine.

  4. Nella casella Scrivi il prompt, inserisci il prompt testuale che descrive le immagini da generare. Ad esempio, piccola barca sull'acqua in un'illustrazione ad acquerello mattutina.

    Per ulteriori informazioni su come scrivere prompt efficaci, consulta la Guida agli attributi di prompt e immagini.

  5. Fai clic su Genera.

REST

Per ulteriori informazioni sull'API Imagen, consulta quanto segue:

Il prompt negativo è un campo facoltativo nell'oggetto parameters di un corpo della richiesta JSON.

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

  • REGION: la regione in cui si trova il progetto. Per ulteriori informazioni sulle regioni supportate, consulta AI generativa su Vertex AI.
  • PROJECT_ID: il tuo Google Cloud ID progetto.

  • MODEL_VERSION: la versione del modello Imagen da utilizzare. Per ulteriori informazioni sui modelli disponibili, consulta Modelli Imagen.

  • TEXT_PROMPT: il prompt testuale che guida le immagini che il modello genera. Questo campo è obbligatorio sia per la generazione sia per la modifica.
  • IMAGE_COUNT: il numero di immagini da generare. L'intervallo di valori accettato è compreso tra 1 e 4.

    • Parametri facoltativi aggiuntivi

    Utilizza le seguenti variabili facoltative a seconda del tuo caso d'uso. Aggiungi alcuni o tutti i seguenti parametri nell'oggetto "parameters": {}. Questo elenco mostra i parametri facoltativi comuni e non è esaustivo. Per ulteriori informazioni sui parametri facoltativi, consulta la documentazione di riferimento dell'API Imagen: Genera immagini. 

    "parameters": {
  "sampleCount": IMAGE_COUNT,
  "addWatermark": ADD_WATERMARK,
  "aspectRatio": "ASPECT_RATIO",
  "enhancePrompt": ENABLE_PROMPT_REWRITING,
  "includeRaiReason": INCLUDE_RAI_REASON,
  "includeSafetyAttributes": INCLUDE_SAFETY_ATTRIBUTES,
  "outputOptions": {
    "mimeType": "MIME_TYPE",
    "compressionQuality": COMPRESSION_QUALITY
  },
  "personGeneration": "PERSON_SETTING",
  "safetySetting": "SAFETY_SETTING",
  "seed": SEED_NUMBER,
  "storageUri": "OUTPUT_STORAGE_URI"
}
    • ADD_WATERMARK: booleano. Facoltativo. Indica se attivare una filigrana per le immagini generate. Qualsiasi immagine generata quando il campo è impostato su true contiene un SynthID digitale che puoi utilizzare per verificare un'immagine con filigrana. Se ometti questo campo, viene utilizzato il valore predefinito true; devi impostare il valore su false per disattivare questa funzionalità. Puoi utilizzare il seed campo per ottenere un output deterministico solo quando questo campo è impostato su false.
    • ASPECT_RATIO: stringa. Facoltativo. Un parametro della modalità di generazione che controlla le proporzioni. Valori delle proporzioni supportati e relativo utilizzo previsto:
      • 1:1 (valore predefinito, quadrato)
      • 3:4 (annunci, social media)
      • 4:3 (TV, fotografia)
      • 16:9 (orizzontale)
      • 9:16 (verticale)
    • ENABLE_PROMPT_REWRITING: booleano. Facoltativo. Un parametro per utilizzare una funzionalità di riscrittura del prompt basata su LLM per fornire immagini di qualità superiore che riflettano meglio l'intent del prompt originale. La disabilitazione di questa funzionalità potrebbe influire sulla qualità delle immagini e sull'aderenza del prompt. Valore predefinito: true.
    • INCLUDE_RAI_REASON: booleano. Facoltativo. Indica se attivare il codice del motivo filtrato dell'AI responsabile nelle risposte con input o output bloccati. Valore predefinito: true.
    • INCLUDE_SAFETY_ATTRIBUTES: booleano. Facoltativo. Indica se attivare i punteggi dell'AI responsabile arrotondati per un elenco di attributi di sicurezza nelle risposte per input e output non filtrati. Categorie di attributi di sicurezza: "Death, Harm & Tragedy", "Firearms & Weapons", "Hate", "Health", "Illicit Drugs", "Politics", "Porn", "Religion & Belief", "Toxic", "Violence", "Vulgarity", "War & Conflict". Valore predefinito: false.
    • MIME_TYPE: stringa. Facoltativo. Il tipo MIME del contenuto dell'immagine. Valori disponibili:
      • image/jpeg
      • image/gif
      • image/png
      • image/webp
      • image/bmp
      • image/tiff
      • image/vnd.microsoft.icon
    • COMPRESSION_QUALITY: numero intero. Facoltativo. Si applica solo ai file di output JPEG. Il livello di dettaglio che il modello conserva per le immagini generate in formato file JPEG. Valori: 0 a 100, dove un numero più alto indica una maggiore compressione. Valore predefinito: 75.
    • PERSON_SETTING: stringa. Facoltativo. L'impostazione di sicurezza che controlla il tipo di persone o la generazione di volti consentita dal modello. Il valore predefinito dipende dal modello. Valori disponibili:
      • allow_all: consente la generazione di persone, inclusi i minori. Questo è il valore predefinito per i modelli di generazione Imagen 4, imagen-3.0-capability-001 e imagen-product-recontext-preview-06-30.
      • allow_adult: consente la generazione solo di adulti, incluse le celebrità. Questo è il valore predefinito per tutti gli altri modelli.
      • dont_allow: disattiva l'inclusione di persone o volti nelle immagini generate.
    • SAFETY_SETTING: stringa. Facoltativo. Un'impostazione che controlla le soglie del filtro di sicurezza per le immagini generate. Valori disponibili:
      • block_low_and_above: la soglia di sicurezza più alta, che comporta la maggiore quantità di immagini generate filtrate. Valore precedente: block_most.
      • block_medium_and_above (valore predefinito): una soglia di sicurezza media che bilancia il filtraggio di contenuti potenzialmente dannosi e sicuri. Valore precedente: block_some.
      • block_only_high: una soglia di sicurezza che riduce il numero di richieste bloccate a causa dei filtri di sicurezza. Questa impostazione potrebbe aumentare i contenuti discutibili generati da Imagen. Valore precedente: block_few.
    • SEED_NUMBER: numero intero. Facoltativo. Qualsiasi numero intero non negativo fornito per rendere deterministiche le immagini di output. Se fornisci lo stesso numero di seed, le immagini di output saranno sempre le stesse. Se il modello che utilizzi supporta la filigrana digitale, devi impostare "addWatermark": false per utilizzare questo campo. Valori interi accettati: 1 - 2147483647.
    • OUTPUT_STORAGE_URI: stringa. Facoltativo. Il bucket Cloud Storage in cui archiviare le immagini di output. Se non viene fornito, nella risposta vengono restituiti i byte dell'immagine codificati in base64. Valore di esempio: gs://image-bucket/output/.

Metodo HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_VERSION:predict

Corpo JSON della richiesta: 

{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT
  }
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

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

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/MODEL_VERSION:predict"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, e quindi esegui il comando seguente: 

$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/MODEL_VERSION:predict" | Select-Object -Expand Content
La seguente risposta di esempio si riferisce a una richiesta con "sampleCount": 2. La risposta restituisce due oggetti di previsione, con i byte dell'immagine generata codificati in base64. 
{
  "predictions": [
    {
      "bytesBase64Encoded": "BASE64_IMG_BYTES",
      "mimeType": "image/png"
    },
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}

Se utilizzi un modello che supporta il miglioramento dei prompt, la risposta include un campo prompt aggiuntivo con il prompt migliorato utilizzato per la generazione: 

{
  "predictions": [
    {
      "mimeType": "MIME_TYPE",
      "prompt": "ENHANCED_PROMPT_1",
      "bytesBase64Encoded": "BASE64_IMG_BYTES_1"
    },
    {
      "mimeType": "MIME_TYPE",
      "prompt": "ENHANCED_PROMPT_2",
      "bytesBase64Encoded": "BASE64_IMG_BYTES_2"
    }
  ]
}

  1. Sostituisci quanto segue:

    • NEGATIVE_PROMPT: un prompt negativo per aiutarti a generare le immagini. Ad esempio: "animali" (rimuove gli animali), "sfocato" (rende l'immagine più nitida), "testo" (rimuove il testo) o "ritagliato" (rimuove le immagini ritagliate). 
    {
  "instances": [
    ...
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "negativePrompt": "NEGATIVE_PROMPT"
  }
}

Passaggi successivi