API Imagen Upscale

Versioni del modello supportate

L'upscaling di Imagen supporta i seguenti modelli:

  • imagen-4.0-upscale-preview

Per saperne di più sulle funzionalità supportate dal modello, consulta Modelli Imagen.

Richiesta HTTP

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_ID:predict \

-d '{
  "instances": [
    {
      "prompt": string,
      "image": {
        // Union field can be only one of the following:
        "bytesBase64Encoded": string,
        "gcsUri": string,
        // End of list of possible types for union field.
      },
    }
  ],
  "parameters": {
    "mode": "upscale",
    "storageUri": string,
    "outputOptions": {
      "mimeType": string,
      "compressionQuality": integer
    },
    "upscaleConfig": {
      "upscaleFactor": string
    }
  }
}'

Istanze

Istanze

Campo unione image.

L'immagine di cui stai aumentando la risoluzione. Puoi fornire una stringa bytesBase64Encoded che codifica un'immagine o una stringa URI gcsUri a una posizione del bucket Cloud Storage.

bytesBase64Encoded

string

Una stringa con codifica base64 di byte di un'immagine o di un file video.
gcsUri

string

Un URI stringa della posizione di un bucket Cloud Storage.

Parametri

Parametri
mode

string

Obbligatorio. Per le richieste di upscaling, trasmetti la stringa "upscale".

storageUri

string

Facoltativo. Un URI stringa alla posizione di un bucket Cloud Storage utilizzato per archiviare le immagini generate. Se non viene fornito un bucket Cloud Storage, nella risposta vengono restituiti i byte dell'immagine codificati in base64.

outputOptions

outputOptions

Facoltativo. Descrive il formato dell'immagine di output in un oggetto outputOptions.

upscaleConfig.upscaleFactor

string

Il fattore di scalabilità per l'immagine di cui è stata aumentata la risoluzione. Sono accettati i seguenti valori:

  • "x2"
  • "x3"
  • "x4"

Oggetto delle opzioni di output

L'oggetto outputOptions descrive l'output dell'immagine.

Parametri
outputOptions.mimeType

(Facoltativo) string

Il formato di output dell'immagine. Sono supportati i seguenti valori:

  • "image/png": Salva come immagine PNG.
  • "image/jpeg": salva come immagine JPEG.

Il valore predefinito è "image/png".
outputOptions.compressionQuality

(Facoltativo) int

Il livello di compressione se il tipo di output è "image/jpeg". I valori accettati sono 0- 100. Il valore predefinito è 75.

Richiesta di esempio

REST

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 località Vertex AI.
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • BASE64_SUBJECT_IMAGE: un'immagine codificata in base64 dell'immagine del soggetto.
  • ADD_WATERMARK: un valore booleano facoltativo. Imposta su true per attivare le immagini con filigrana o su false per disattivarle. Il valore predefinito è true.
  • GCS_IMAGE_PATH: Un percorso Cloud Storage a un file immagine.
  • GCS_OUTPUT_PATH: il percorso Cloud Storage in cui archiviare l'output generato.
  • OUTPUT_MIMETYPE: una stringa facoltativa che definisce il tipo di file di output dell'immagine. Sono accettati i seguenti valori: "image/png" o "image/jpeg". Il valore predefinito è "image/png".
  • COMPRESSION_QUALITY: un valore intero facoltativo che specifica il livello di dettaglio che il modello conserva per le immagini JPEG. Viene accettato il seguente intervallo di valori: 0 - 100. Il valore più alto specifica un livello di compressione più elevato. Il valore predefinito è 75.
  • UPSCALE_FACTOR: Il fattore di scalabilità per l'immagine di upscaling. La risoluzione di output finale dell'immagine dopo l'applicazione del fattore di upscaling non deve superare i 17 megapixel. Sono accettati i seguenti valori:
    • "x2"
    • "x3"
    • "x4"

Metodo HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/imagen-4.0-upscale-preview:predict

Corpo JSON della richiesta: 

{
  "instances": [
    {
      "prompt": "Upscale the image",
      "image": {
        // use one of the following to specify the image to upscale
        "bytesBase64Encoded": "BASE64_SUBJECT_IMAGE"
        "gcsUri": "GCS_IMAGE_PATH"
        // end of base image input options
      },
    }
  ],
  "parameters": {
    "mode": "upscale",
    "storageUri": "GCS_OUTPUT_PATH",
    "outputOptions": {
      "mimeType": "OUTPUT_MIMETYPE",
      "compressionQuality": COMPRESSION_QUALITY
    },
    "upscaleConfig": {
      "upscaleFactor": "UPSCALE_FACTOR"
    }
  }
}

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/imagen-4.0-upscale-preview:predict"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, 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/imagen-4.0-upscale-preview:predict" | Select-Object -Expand Content
La richiesta restituisce un oggetto immagine. In questo esempio, un oggetto immagine viene restituito come oggetto di previsione con un'immagine codificata in base64. 
{
  "predictions": [
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}