API peningkatan kualitas gambar Imagen

Versi model yang didukung

Peningkatan kualitas Imagen mendukung model berikut:

  • imagen-4.0-upscale-preview

Untuk mengetahui informasi selengkapnya tentang fitur yang didukung model, lihat Model Imagen.

Permintaan 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
    }
  }
}'

Instance

Instance

Kolom union image.

Gambar yang Anda tingkatkan kualitasnya. Anda dapat memberikan string bytesBase64Encoded yang mengenkode gambar atau URI string gcsUri ke lokasi bucket Cloud Storage.

bytesBase64Encoded

string

String berenkode base64 byte dari file gambar atau video.
gcsUri

string

URI string ke lokasi bucket Cloud Storage.

Parameter

Parameter
mode

string

Wajib. Untuk permintaan peningkatan kualitas, teruskan string "upscale".

storageUri

string

Opsional. URI string ke lokasi bucket Cloud Storage yang digunakan untuk menyimpan gambar yang dihasilkan. Jika bucket Cloud Storage tidak diberikan, byte gambar berenkode base64 akan ditampilkan dalam respons.

outputOptions

outputOptions

Opsional. Mendeskripsikan format gambar output dalam objek outputOptions.

upscaleConfig.upscaleFactor

string

Faktor penskalaan untuk gambar yang ditingkatkan skalanya. Nilai berikut diterima:

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

Objek opsi output

Objek outputOptions menjelaskan output gambar.

Parameter
outputOptions.mimeType

Opsional: string

Format output gambar. Nilai-nilai berikut didukung:

  • "image/png": Simpan sebagai gambar PNG.
  • "image/jpeg": Simpan sebagai gambar JPEG.

Nilai defaultnya adalah "image/png".
outputOptions.compressionQuality

Opsional: int

Tingkat kompresi jika jenis outputnya adalah "image/jpeg". Nilai yang diterima adalah 0- 100. Nilai defaultnya adalah 75.

Permintaan sampel

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGION: Region tempat project Anda berada. Untuk mengetahui informasi selengkapnya tentang region yang didukung, lihat Lokasi AI Generatif di Vertex AI.
  • PROJECT_ID: Google Cloud Project ID Anda.
  • BASE64_SUBJECT_IMAGE: Gambar subjek yang dienkode base64.
  • ADD_WATERMARK: Nilai Boolean opsional. Setel ke true untuk mengaktifkan gambar yang memiliki watermark, atau false untuk menonaktifkan gambar yang memiliki watermark. Nilai defaultnya adalah true.
  • GCS_IMAGE_PATH: Jalur Cloud Storage ke file gambar.
  • GCS_OUTPUT_PATH: jalur Cloud Storage untuk menyimpan output yang dihasilkan.
  • OUTPUT_MIMETYPE: String opsional yang menentukan jenis file output gambar. Nilai berikut diterima: "image/png" atau "image/jpeg". Defaultnya adalah "image/png".
  • COMPRESSION_QUALITY: Nilai bilangan bulat opsional yang menentukan tingkat detail yang dipertahankan model untuk gambar JPEG. Rentang nilai berikut diterima: 0 - 100. Nilai yang lebih tinggi menentukan tingkat kompresi yang lebih tinggi. Defaultnya adalah 75.
  • UPSCALE_FACTOR: Faktor penskalaan untuk gambar yang di-upscale. Resolusi output akhir gambar setelah menerapkan faktor peningkatan kualitas tidak boleh melebihi 17 megapiksel. Nilai berikut diterima:
    • "x2"
    • "x3"
    • "x4"

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "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"
    }
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$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
Permintaan ini akan menampilkan objek gambar. Dalam contoh ini, objek gambar ditampilkan sebagai objek prediksi dengan gambar berenkode base64. 
{
  "predictions": [
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}