Membuat gambar menggunakan perintah teks

Anda dapat menggunakan Imagen di Vertex AI untuk membuat gambar baru dari perintah teks. Antarmuka yang didukung mencakup konsol Google Cloud dan Vertex AI API.

Untuk mengetahui informasi selengkapnya tentang cara menulis perintah teks untuk pembuatan dan pengeditan gambar, lihat panduan permintaan.

Melihat kartu model Imagen untuk Pembuatan Gambar

Mencoba pembuatan gambar (Vertex AI Studio)

Sebelum memulai

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

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

  8. Siapkan autentikasi untuk lingkungan Anda.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    Java

    Untuk menggunakan contoh Java di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Install the Google Cloud CLI.

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

    3. To initialize the gcloud CLI, run the following command: 

      gcloud init

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

      5. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

    Node.js

    Untuk menggunakan contoh Node.js di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Install the Google Cloud CLI.

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

    3. To initialize the gcloud CLI, run the following command: 

      gcloud init

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

      5. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

    Python

    Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Install the Google Cloud CLI.

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

    3. To initialize the gcloud CLI, run the following command: 

      gcloud init

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

      5. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      After installing the Google Cloud CLI, initialize it 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.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

    Membuat gambar dengan teks

    Anda dapat membuat gambar baru menggunakan teks deskriptif sebagai input. Contoh berikut menunjukkan petunjuk dasar untuk membuat gambar, tetapi Anda juga dapat menggunakan parameter tambahan, bergantung pada kasus penggunaan Anda.

    Konsol

    1. Di Google Cloud konsol, buka halaman Vertex AI Studio > Media Studio.

      Buka Media Studio

    2. Klik Gambar.

    3. Opsional: Di panel Setelan, konfigurasikan setelan berikut:

      • Model: pilih model dari opsi yang tersedia.

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

      • Rasio aspek: pilih rasio aspek dari opsi yang tersedia.

      • Jumlah hasil: sesuaikan penggeser atau masukkan nilai antara 1 dan 4.

    4. Opsional: Di bagian Advanced options, pilih Region untuk membuat gambar Anda.

    5. Di kotak Write your prompt, masukkan perintah teks yang menjelaskan gambar yang akan dibuat. Misalnya, ilustrasi cat air perahu kecil di atas air pada pagi hari.

      Untuk mengetahui detail informasi selengkapnya tentang cara menulis perintah yang efektif, lihat Panduan perintah dan atribut gambar.

    6. Klik Buat.

      Watermark digital otomatis ditambahkan ke gambar yang dihasilkan. Anda tidak dapat menonaktifkan watermark digital untuk pembuatan gambar menggunakan konsol Google Cloud .

      Anda dapat memilih gambar untuk dilihat di jendela Detail gambar. Gambar dengan watermark berisi badge Watermark digital. Anda juga dapat memverifikasi watermark gambar secara eksplisit.

      Contoh gambar yang dibuat menggunakan teks dan diberi tanda air Tampilan
      Detail gambar dari gambar yang diberi watermark yang dibuat dengan Imagen 2 dari perintah: ilustrasi cat air dengan warna redup berisi perahu merah kecil di atas air pada pagi hari.

    Python

    Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai Vertex AI menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Python Vertex AI.

    Untuk melakukan autentikasi ke Vertex AI, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

    Dalam contoh ini, Anda memanggil metode generate_images pada ImageGenerationModel dan menyimpan gambar yang dihasilkan secara lokal. Kemudian, Anda dapat memilih menggunakan metode show() di notebook untuk menampilkan gambar yang dihasilkan. Untuk mengetahui informasi selengkapnya tentang versi dan fitur model, lihat Model Imagen.

    from google import genai

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-preview-06-06",
    prompt="A dog reading a newspaper",
)

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

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: Google Cloud Project ID Anda.

    • MODEL_VERSION: Versi model imagegeneration yang akan digunakan. Berikut adalah versi model yang tersedia untuk digunakan:

      Imagen 4:

      • imagen-4.0-generate-preview-06-06
      • imagen-4.0-ultra-generate-preview-06-06
      • imagen-4.0-fast-generate-preview-06-06

      Imagen 3:

      • imagen-3.0-generate-002
      • imagen-3.0-generate-001
      • imagen-3.0-fast-generate-001
    • LOCATION: Region project Anda. Misalnya, us-central1, europe-west2, atau asia-northeast3. Untuk mengetahui daftar region yang tersedia, lihat Lokasi AI Generatif di Vertex AI.
    • TEXT_PROMPT: Perintah teks yang memandu gambar yang dihasilkan model. Kolom ini wajib diisi untuk pembuatan dan pengeditan.
    • IMAGE_COUNT: Jumlah gambar yang dihasilkan. Nilai bilangan bulat yang diterima: 1-8 (imagegeneration@002), 1-4 (semua versi model lainnya). Nilai default: 4.

      • Parameter opsional tambahan

      Gunakan variabel opsional berikut bergantung pada kasus penggunaan Anda. Tambahkan beberapa atau semua parameter berikut dalam objek "parameters": {}. Daftar ini menampilkan parameter opsional umum dan tidak dimaksudkan untuk menjadi lengkap. Untuk mengetahui informasi selengkapnya tentang parameter opsional, lihat Referensi API Imagen: Membuat gambar. 

      "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: boolean. Opsional. Apakah akan mengaktifkan watermark untuk gambar yang dihasilkan. Gambar apa pun yang dihasilkan saat kolom disetel ke true berisi SynthID digital yang dapat Anda gunakan untuk memverifikasi gambar yang diberi watermark. Jika Anda menghapus kolom ini, nilai default true akan digunakan; Anda harus menetapkan nilai ke false untuk menonaktifkan fitur ini. Anda dapat menggunakan kolom seed untuk mendapatkan output deterministik hanya jika kolom ini ditetapkan ke false.
      • ASPECT_RATIO: string. Opsional. Parameter mode pembuatan yang mengontrol rasio aspek. Nilai rasio yang didukung dan penggunaan yang dimaksudkan:
        • 1:1 (default, persegi)
        • 3:4 (Iklan, media sosial)
        • 4:3 (TV, fotografi)
        • 16:9 (lanskap)
        • 9:16 (potret)
      • ENABLE_PROMPT_REWRITING: boolean. Opsional. Parameter untuk menggunakan fitur penulisan ulang perintah berbasis LLM guna menghasilkan gambar berkualitas lebih tinggi yang lebih mencerminkan maksud perintah asli. Menonaktifkan fitur ini dapat memengaruhi kualitas gambar dan kepatuhan perintah. Nilai default: true.
      • INCLUDE_RAI_REASON: boolean. Opsional. Apakah akan mengaktifkan kode alasan yang difilter Responsible AI dalam respons dengan input atau output yang diblokir. Nilai default: false.
      • INCLUDE_SAFETY_ATTRIBUTES: boolean. Opsional. Apakah akan mengaktifkan skor Responsible AI yang dibulatkan untuk daftar atribut keamanan dalam respons untuk input dan output yang tidak difilter. Kategori atribut keamanan: "Death, Harm & Tragedy", "Firearms & Weapons", "Hate", "Health", "Illicit Drugs", "Politics", "Porn", "Religion & Belief", "Toxic", "Violence", "Vulgarity", "War & Conflict". Nilai default: false.
      • MIME_TYPE: string. Opsional. Jenis MIME konten gambar. Nilai yang tersedia:
        • image/jpeg
        • image/gif
        • image/png
        • image/webp
        • image/bmp
        • image/tiff
        • image/vnd.microsoft.icon
      • COMPRESSION_QUALITY: bilangan bulat. Opsional. Hanya berlaku untuk file output JPEG. Tingkat detail yang dipertahankan model untuk gambar yang dihasilkan dalam format file JPEG. Nilai: 0 hingga 100, dengan angka yang lebih tinggi berarti kompresi yang lebih besar. Default: 75.
      • PERSON_SETTING: string. Opsional. Setelan keamanan yang mengontrol jenis orang atau pembuatan wajah yang diizinkan oleh model. Nilai yang tersedia:
        • allow_adult (default): Mengizinkan pembuatan konten khusus dewasa, kecuali pembuatan konten selebritas. Pembuatan gambar selebritas tidak diizinkan untuk setelan apa pun.
        • dont_allow: Menonaktifkan penyertaan orang atau wajah dalam gambar yang dihasilkan.
      • SAFETY_SETTING: string. Opsional. Setelan yang mengontrol batas filter keamanan untuk gambar yang dihasilkan. Nilai yang tersedia:
        • block_low_and_above: Nilai minimum keamanan tertinggi, sehingga menghasilkan jumlah gambar yang dihasilkan paling banyak yang difilter. Nilai sebelumnya: block_most.
        • block_medium_and_above (default): Batas keamanan sedang yang menyeimbangkan pemfilteran untuk konten yang berpotensi berbahaya dan aman. Nilai sebelumnya: block_some.
        • block_only_high: Batas keamanan yang mengurangi jumlah permintaan yang diblokir karena filter keamanan. Setelan ini dapat meningkatkan konten tidak pantas yang dihasilkan oleh Imagen. Nilai sebelumnya: block_few.
      • SEED_NUMBER: bilangan bulat. Opsional. Bilangan bulat non-negatif yang Anda berikan untuk membuat gambar output menjadi deterministik. Memberikan nomor seed yang sama akan selalu menghasilkan gambar output yang sama. Jika model yang Anda gunakan mendukung watermark digital, Anda harus menyetel "addWatermark": false untuk menggunakan kolom ini. Nilai bilangan bulat yang diterima: 1 - 2147483647.
      • OUTPUT_STORAGE_URI: string. Opsional. Bucket Cloud Storage untuk menyimpan gambar output. Jika tidak diberikan, byte gambar berenkode base64 akan ditampilkan dalam respons. Contoh nilai: gs://image-bucket/output/.

    Metode HTTP dan URL: 

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

    Isi JSON permintaan: 

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

    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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_VERSION: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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_VERSION:predict" | Select-Object -Expand Content
    Contoh respons berikut adalah untuk permintaan dengan "sampleCount": 2. Respons ini menampilkan dua objek prediksi, dengan byte gambar yang dihasilkan berenkode base64. 
    {
  "predictions": [
    {
      "bytesBase64Encoded": "BASE64_IMG_BYTES",
      "mimeType": "image/png"
    },
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}

    Jika Anda menggunakan model yang mendukung peningkatan kualitas perintah, respons akan menyertakan kolom prompt tambahan dengan perintah yang ditingkatkan kualitasnya yang digunakan untuk pembuatan: 

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

    Lokasi

    Lokasi adalah region yang dapat Anda tentukan dalam permintaan untuk mengontrol tempat data disimpan dalam penyimpanan. Untuk mengetahui daftar region yang tersedia, lihat Lokasi AI Generatif di Vertex AI.

    Pemfilteran keamanan

    Data input dan konten output diperiksa untuk mendeteksi materi yang menyinggung saat Anda mengirim permintaan pembuatan gambar ke Imagen. Artinya, input perintah teks yang menyinggung dapat diblokir. Demikian pula, gambar output yang menyinggung juga dapat diblokir, sehingga memengaruhi jumlah gambar yang dihasilkan yang Anda dapatkan dalam respons.

    Untuk mengetahui informasi selengkapnya tentang pemfilteran keamanan dan penanganan konten yang diblokir, lihat Responsible AI dan panduan penggunaan untuk Imagen.

    Versi model

    Ada beberapa model pembuatan gambar yang dapat Anda gunakan. Untuk mengetahui informasi selengkapnya, lihat Model Imagen.

    Menambahkan atau memverifikasi watermark gambar

    Secara default, watermark digital ditambahkan ke gambar apa pun yang dibuat oleh versi model yang mendukung pembuatan watermark. Fitur ini menambahkan watermark digital yang tidak terlihat—yang disebut SynthID—ke gambar. Kemudian, Anda dapat memverifikasi apakah suatu gambar berisi watermark digital atau tidak.

    Menggunakan parameter untuk membuat gambar

    Saat membuat gambar, ada beberapa parameter standar dan lanjutan yang dapat Anda tetapkan, bergantung pada kasus penggunaan Anda.

    Mengonfigurasi setelan keamanan Responsible AI (RAI)

    Ada beberapa parameter pemfilteran AI Bertanggung Jawab (RAI) yang dapat Anda gunakan dengan model pembuatan gambar. Misalnya, Anda dapat mengizinkan model melaporkan kode filter RAI untuk konten yang diblokir, menonaktifkan pembuatan orang atau wajah menggunakan filter RAI, menetapkan tingkat pemfilteran konten, atau menampilkan skor RAI yang dibulatkan dari daftar atribut keamanan untuk input dan output.

    Untuk mengetahui informasi yang lebih mendetail tentang Responsible AI (RAI), parameter terkait, dan contoh outputnya, lihat Memahami dan mengonfigurasi Responsible AI untuk Imagen.

    Contoh berikut menunjukkan cara menyetel parameter RAI yang tersedia untuk pembuatan gambar.

    Konsol

    1. Di Google Cloud konsol, buka halaman Vertex AI Studio > Media Studio.

      Buka Media Studio

    2. Klik Gambar.

    3. Di bagian Keamanan, konfigurasikan setelan berikut:

      • Pilih salah satu setelan Pembuatan orang berikut:

        • Izinkan (Khusus dewasa): hanya membuat orang atau wajah dewasa. Jangan membuat gambar orang atau wajah anak-anak atau remaja.
        • Izinkan (Semua usia): menghasilkan orang atau wajah dari semua usia.
        • Jangan izinkan: tidak membuat orang atau wajah.

      • Pilih salah satu setelan Batas filter keamanan berikut:

        • Blokir sebagian besar: memblokir sebagian besar konten berbahaya.
        • Memblokir sebagian: memblokir beberapa perintah dan respons yang bermasalah.
        • Blokir sedikit: memblokir sedikit perintah dan respons yang bermasalah.

    4. Di kotak Tulis perintah Anda, masukkan perintah teks yang menjelaskan gambar yang akan dibuat. Misalnya, ilustrasi cat air perahu kecil di atas air pada pagi hari.

    5. Klik Buat.

    REST

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: Google Cloud Project ID Anda.
    • LOCATION: Region project Anda. Misalnya, us-central1, europe-west2, atau asia-northeast3. Untuk mengetahui daftar region yang tersedia, lihat Lokasi AI Generatif di Vertex AI.
    • TEXT_PROMPT: Perintah teks yang memandu gambar yang dihasilkan model. Kolom ini wajib diisi untuk pembuatan dan pengeditan.
    • IMAGE_COUNT: Jumlah gambar yang dihasilkan. Nilai bilangan bulat yang diterima: 1-8 (imagegeneration@002), 1-4 (semua versi model lainnya). Nilai default: 4.
    • SAFETY_SETTING: string. Opsional. Setelan yang mengontrol batas filter keamanan untuk gambar yang dihasilkan. Nilai yang tersedia:
      • block_low_and_above: Nilai minimum keamanan tertinggi, sehingga menghasilkan jumlah gambar yang dihasilkan paling banyak yang difilter. Nilai sebelumnya: block_most.
      • block_medium_and_above (default): Batas keamanan sedang yang menyeimbangkan pemfilteran untuk konten yang berpotensi berbahaya dan aman. Nilai sebelumnya: block_some.
      • block_only_high: Batas keamanan yang mengurangi jumlah permintaan yang diblokir karena filter keamanan. Setelan ini dapat meningkatkan konten tidak pantas yang dihasilkan oleh Imagen. Nilai sebelumnya: block_few.
    • PERSON_SETTING: string. Opsional. Setelan keamanan yang mengontrol jenis orang atau pembuatan wajah yang diizinkan oleh model. Nilai yang tersedia:
      • allow_adult (default): Mengizinkan pembuatan konten khusus dewasa, kecuali pembuatan konten selebritas. Pembuatan gambar selebritas tidak diizinkan untuk setelan apa pun.
      • dont_allow: Menonaktifkan penyertaan orang atau wajah dalam gambar yang dihasilkan.
    • INCLUDE_RAI_REASON: boolean. Opsional. Apakah akan mengaktifkan kode alasan yang difilter Responsible AI dalam respons dengan input atau output yang diblokir. Nilai default: false.
    • INCLUDE_SAFETY_ATTRIBUTES: boolean. Opsional. Apakah akan mengaktifkan skor Responsible AI yang dibulatkan untuk daftar atribut keamanan dalam respons untuk input dan output yang tidak difilter. Kategori atribut keamanan: "Death, Harm & Tragedy", "Firearms & Weapons", "Hate", "Health", "Illicit Drugs", "Politics", "Porn", "Religion & Belief", "Toxic", "Violence", "Vulgarity", "War & Conflict". Nilai default: false.

    Metode HTTP dan URL: 

    POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@006:predict

    Isi JSON permintaan: 

    {
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "safetySetting": "SAFETY_SETTING",
    "personGeneration": "PERSON_SETTING",
    "includeRaiReason": INCLUDE_RAI_REASON,
    "includeSafetyAttributes": INCLUDE_SAFETY_ATTRIBUTES
  }
}

    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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@006: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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@006:predict" | Select-Object -Expand Content
    Respons yang Anda dapatkan bergantung pada setelan keamanan yang Anda tetapkan. Untuk mengetahui informasi selengkapnya, lihat Memahami dan mengonfigurasi Responsible AI (RAI) untuk Imagen.

    Peningkatan kualitas perintah menggunakan alat penulisan ulang perintah

    Imagen di Vertex AI menawarkan alat penulisan ulang perintah berbasis LLM, yang juga dikenal sebagai penulis ulang perintah. Alat ini dapat menambahkan detail lainnya ke perintah yang Anda berikan untuk menghasilkan gambar output berkualitas lebih tinggi yang lebih mencerminkan perintah Anda.

    Jika Anda menonaktifkan penulis ulang perintah, kualitas gambar dan seberapa baik output menyerupai perintah yang Anda berikan dapat terpengaruh. Fitur ini diaktifkan secara default untuk versi model berikut:

    • imagen-4.0-generate-preview-06-06 (Pratinjau)
    • imagen-4.0-fast-generate-preview-06-06 (Pratinjau)
    • imagen-4.0-ultra-generate-preview-06-06 (Pratinjau)
    • imagen-3.0-generate-002
    • imagen-3.0-generate-001

    Perintah yang ditulis ulang hanya dikirimkan oleh respons API jika perintah asli memiliki panjang kurang dari 30 kata.

    Konsol

    1. Di Google Cloud konsol, buka halaman Vertex AI Studio > Media Studio.

      Buka Media Studio

    2. Klik Gambar.

    3. Di kotak Tulis perintah Anda, klik Bantu tulis.

      Jendela Tingkatkan kualitas perintah saya akan ditampilkan.

    4. Di kotak Perintah saat ini, tulis perintah Anda, lalu klik Tingkatkan.

      Perintah yang ditulis ulang ditampilkan di kotak Perintah yang ditingkatkan. Anda dapat mengedit perintah yang ditingkatkan atau menggunakannya seperti yang ditampilkan.

    5. Klik Sisipkan untuk menggunakan perintah yang ditampilkan.

      Perintah dimasukkan ke dalam kotak Tulis perintah Anda.

    6. Klik Buat.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: Google Cloud Project ID Anda.
    • MODEL_VERSION: Versi model pembuatan gambar yang akan digunakan.

      Untuk mengetahui informasi selengkapnya tentang versi dan fitur model, lihat versi model.

    • LOCATION: Region project Anda. Misalnya, us-central1, europe-west2, atau asia-northeast3. Untuk mengetahui daftar region yang tersedia, lihat Lokasi AI Generatif di Vertex AI.
    • TEXT_PROMPT: Perintah teks yang memandu gambar yang dihasilkan model. Sebelum gambar dibuat, perintah dasar ini ditingkatkan dengan detail dan bahasa deskriptif yang lebih banyak menggunakan alat penulisan ulang perintah berbasis LLM.
    • IMAGE_COUNT: Jumlah gambar yang dihasilkan. Nilai bilangan bulat yang diterima: 1-4. Nilai default: 4.
    • enhancePrompt - Boolean untuk mengaktifkan peningkatan perintah berbasis LLM. Secara default, nilai ini ditetapkan ke true.

    Metode HTTP dan URL: 

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

    Isi JSON permintaan: 

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

    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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_VERSION: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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_VERSION:predict" | Select-Object -Expand Content
    Jika peningkatan perintah diaktifkan, respons akan menyertakan kolom prompt tambahan yang menampilkan perintah yang ditingkatkan dan gambar yang dihasilkan terkait: 
      {
    "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"
      }
    ]
  }

    Misalnya, contoh respons berikut adalah untuk permintaan dengan "sampleCount": 2 dan "prompt": "A raccoon wearing formal clothes, wearing a top hat. Oil painting in the style of Vincent Van Gogh.". Respons ini menampilkan dua objek prediksi, masing-masing dengan perintah yang ditingkatkan dan byte gambar yang dihasilkan berenkode base64. 

    {
  "predictions": [
    {
      "mimeType": "image/png",
      "prompt": "An oil painting in the style of Vincent van Gogh, depicting a raccoon adorned
        in a finely tailored tuxedo, complete with a crisp white shirt and a bow tie. The raccoon
        also sports a classic top hat, perched jauntily on its head. The painting uses thick,
        swirling brushstrokes characteristic of van Gogh, with vibrant hues of blue, yellow, and
        green in the background, contrasting with the dark tones of the raccoon's attire. The light
        source is subtly placed, casting a dramatic shadow of the raccoon's attire onto the surface
        it sits upon, further enhancing the depth and dimensionality of the composition. The
        overall impression is one of a whimsical and sophisticated character, a raccoon elevated to
        a higher class through its formal attire, rendered in van Gogh's iconic style.",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    },
    {
      "mimeType": "image/png",
      "prompt": "An oil painting in the style of Vincent van Gogh featuring a raccoon in a
        dapper suit, complete with a black jacket, crisp white shirt, and a black bow tie. The
        raccoon is wearing a black top hat, adding a touch of elegance to its ensemble. The
        painting is rendered with characteristic van Gogh brushwork, utilizing thick, impasto
        strokes of color. The background is a swirl of blues, greens, and yellows, creating a
        vibrant yet slightly chaotic atmosphere that contrasts with the raccoon's formal attire.
        The lighting is dramatic, casting sharp shadows and highlighting the textures of the fabric
        and the raccoon's fur, enhancing the sense of realism within the fantastical scene. The
        composition focuses on the raccoon's proud posture, highlighting the whimsical contrast of
        a wild animal dressed in formal attire, captured in the unique artistic language of van
        Gogh. ",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}

    Bahasa perintah teks

    Parameter opsional ini memungkinkan Anda menetapkan bahasa teks input untuk pembuatan atau pengeditan gambar.

    gambar buku yang dibuat dari perintah dalam bahasa Hindi
    Gambar yang dihasilkan dari perintah: ऊपर से देखा गया किताबों का ढेर। सबसे ऊपरी पुस्तक में एक पक्षी का जलरंग चित्रण है। किताब पर VERTEX AI मोटे अक्षरों में लिखा हुआ है 1

    1 Tumpukan buku yang dilihat dari atas. Buku paling atas berisi ilustrasi burung cat air. VERTEX AI ditulis dengan huruf tebal di buku.
    gambar seorang perempuan dari perintah dalam bahasa Korea
    Gambar yang dibuat dari perintah: Foto mode postmodern seorang wanita yang memakai anting-anting dan pakaian berwarna cerah dengan warna kuning tua dan biru kehijauan tua 2

    2 Woman wearing bright colors, in the style of dark yellow and dark cyan, wearing earrings, postmodern fashion photography.

    Sebelum memulai

    Sebelum Anda menggunakan fitur ini, selesaikan langkah-langkah berikut:

    1. Untuk membuat identitas layanan yang akan digunakan Vertex AI di project Anda, gunakan perintah berikut:

      gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID

    2. Minta akses fitur. Untuk meminta akses, kirim email ke grup Google Cloud Trusted Testers Access: GenApp Builder. Sebutkan Perintah Multi-Bahasa dalam pesan Anda, dan sertakan nomor project Anda. Proses persetujuan biasanya memerlukan waktu beberapa jam.

    Menetapkan bahasa perintah teks

    Nilai input berikut didukung untuk bahasa perintah teks:

    • China (Aksara Sederhana) (zh/zh-CN)
    • China (Aksara Tradisional) (zh-TW)
    • Inggris (en, nilai default)
    • Hindi (hi)
    • Jepang (ja)
    • Korea (ko)
    • Portugis (pt)

    • Spanyol (es)

    Konsol

    Jika perintah Anda menggunakan salah satu bahasa yang didukung, Imagen akan mendeteksi dan menerjemahkan teks Anda, lalu menampilkan gambar yang dibuat atau diedit.

    Jika perintah Anda menggunakan bahasa yang tidak didukung, Imagen akan menggunakan teks tersebut kata demi kata untuk permintaan. Hal ini dapat menghasilkan output yang tidak terduga.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: Google Cloud Project ID Anda.
    • TEXT_PROMPT: Perintah teks yang memandu gambar yang dihasilkan model. Kolom ini wajib diisi untuk pembuatan dan pengeditan.
    • PROMPT_LANGUAGE: string. Opsional. Kode bahasa yang sesuai dengan bahasa perintah teks Anda. Dalam contoh ini, nilainya adalah hi. Nilai yang tersedia:
      • auto - Deteksi otomatis. Jika Imagen mendeteksi bahasa yang didukung, perintah (dan secara opsional, perintah negatif), akan diterjemahkan ke dalam bahasa Inggris. Jika bahasa yang terdeteksi tidak didukung, Imagen menggunakan teks input apa adanya, yang dapat menghasilkan output yang tidak terduga. Tidak ada kode error yang ditampilkan.
      • en - Inggris (nilai default jika tidak ada)
      • es - Spanyol
      • hi - Hindi
      • ja - Jepang
      • ko - Korea
      • pt - Portugis
      • zh-TW - China (aksara tradisional)
      • zh atau zh-CN - China (Aksara Sederhana)

    Metode HTTP dan URL: 

    POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict

    Isi JSON permintaan: 

    {
  "instances": [
    {
      "prompt": "सूर्यास्त के समय एक समुद्र तट। उड़ते पक्षी, हवा में लहराते नारियल के पेड़। लोग समुद्र तट पर सैर का आनंद ले रहे हैं।"
    }
  ],
  "parameters": {
    "language": "PROMPT_LANGUAGE"
  }
}

    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://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005: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://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict" | Select-Object -Expand Content
    Contoh respons berikut adalah untuk permintaan dengan "sampleCount": 2. Respons ini menampilkan dua objek prediksi, dengan byte gambar yang dihasilkan berenkode base64. 
    {
  "predictions": [
    {
      "bytesBase64Encoded": "BASE64_IMG_BYTES",
      "mimeType": "image/png"
    },
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "BASE64_IMG_BYTES"
    }
  ]
}

    Rasio aspek

    Bergantung pada cara Anda berencana menggunakan gambar yang dihasilkan, beberapa rasio aspek mungkin berfungsi lebih baik daripada yang lain. Pilih rasio aspek yang paling sesuai dengan kasus penggunaan Anda.

    Rasio aspek Penggunaan yang dimaksudkan Contoh gambar
    1:1 default, persegi, penggunaan umum
    Contoh gambar yang dibuat di konsol
    Perintah: foto dari atas makan malam pasta, foto studio dengan gaya sampul majalah makanan.
    3:4 TV, media, film
    Contoh gambar yang dibuat di konsol
    Perintah: pemotretan komersial, iklan parfum, botol beraroma lavender vanila dengan latar belakang berwarna terang.
    4:3 TV, media, film
    Contoh gambar yang dibuat di konsol
    Perintah: pemotretan komersial, sepatu kets high top hijau dan abu-abu, 4k, sudut dramatis.
    9:16 potret, objek tinggi, perangkat seluler
    Contoh gambar yang dibuat di konsol
    Perintah: fotografi alam, pantai di hawaii dengan lautan di latar belakang, suar lensa, matahari terbenam.
    16:9 lanskap
    Contoh gambar yang dibuat di konsol
    Perintah: gedung pencakar langit di new york city, rendering futuristik, konsep, seni digital.

    Konsol

    1. Ikuti petunjuk membuat gambar dengan teks untuk membuka Vertex AI Studio dan memasukkan perintah teks Anda.

    2. Di panel Parameter, pilih rasio aspek dari menu Rasio aspek.

    3. Klik Generate.

    REST

    Rasio aspek adalah kolom opsional dalam objek parameters dari isi permintaan JSON.

    1. Ikuti petunjuk buat gambar dengan teks untuk mengganti variabel isi permintaan lainnya.

    2. Ganti kode berikut:

      • ASPECT_RATIO: string. Opsional. Parameter mode pembuatan yang mengontrol rasio aspek. Nilai rasio yang didukung dan penggunaan yang dimaksudkan:
        • 1:1 (default, persegi)
        • 3:4 (Iklan, media sosial)
        • 4:3 (TV, fotografi)
        • 16:9 (lanskap)
        • 9:16 (potret)
      {
  "instances": [
    ...
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "aspectRatio": "ASPECT_RATIO"
  }
}

    3. Ikuti petunjuk membuat gambar dengan teks untuk mengirim permintaan REST Anda.

    Perintah negatif

    Perintah negatif adalah deskripsi tentang hal yang ingin Anda hapus dalam gambar yang dibuat. Misalnya, perintah "jalanan kota di malam hari saat turun hujan tanpa satu orang pun". Model dapat menafsirkan "orang" sebagai perintah untuk menyertakan, bukan menghilangkan. Untuk memberikan hasil yang lebih baik, Anda dapat menggunakan perintah "jalanan kota di malam hari saat turun hujan" dengan perintah negatif "orang".

    Imagen membuat gambar ini dengan dan tanpa dialog negatif:

    Khusus perintah teks

    • Perintah teks: "pizza"

    tiga contoh gambar pizza

    Perintah teks dan perintah negatif

    • Perintah teks: "pizza"
    • Perintah negatif: "pepperoni"

    tiga contoh gambar pizza tanpa pepperoni

    Model berikut mendukung prompt negatif:

    • imagen-3.0-capability-001
    • imagen-3.0-fast-generate-001

    • imagen-3.0-generate-001

    Konsol

    1. Di Google Cloud konsol, buka halaman Vertex AI Studio > Media Studio.

      Buka Media Studio

    2. Klik Gambar.

    3. Opsional: Di panel Setelan, konfigurasikan setelan berikut:

      • Model: pilih salah satu model berikut:

        • imagen-3.0-capability-001
        • imagen-3.0-fast-generate-001
        • imagen-3.0-generate-001

        Untuk mengetahui informasi selengkapnya tentang model yang tersedia, lihat Model Imagen

      • Rasio aspek: pilih rasio aspek dari opsi yang tersedia.

      • Jumlah hasil: sesuaikan penggeser atau masukkan nilai antara 1 dan 4.

      • Di kotak Negative prompt, masukkan perintah yang menjelaskan hal yang tidak ingin Anda hasilkan dalam gambar.

    4. Di kotak Tulis perintah Anda, masukkan perintah teks yang menjelaskan gambar yang akan dibuat. Misalnya, ilustrasi cat air perahu kecil di atas air pada pagi hari.

      Untuk mengetahui detail informasi selengkapnya tentang cara menulis perintah yang efektif, lihat Panduan atribut perintah dan gambar.

    5. Klik Buat.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Prompt negatif adalah kolom opsional dalam objek parameters dari isi permintaan JSON.

    1. Ikuti petunjuk buat gambar dengan teks untuk mengganti variabel isi permintaan lainnya.

    2. Ganti kode berikut:

      • NEGATIVE_PROMPT: Perintah negatif untuk membantu membuat gambar. Misalnya: "hewan" (menghapus hewan), "buram" (memperjelas gambar), "teks" (menghapus teks), atau "terpangkas" (menghapus gambar yang dipangkas). 
      {
  "instances": [
    ...
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "negativePrompt": "NEGATIVE_PROMPT"
  }
}

    3. Ikuti petunjuk membuat gambar dengan teks untuk mengirim permintaan REST Anda.

    Nomor seed

    Nomor seed adalah angka yang Anda tambahkan ke permintaan untuk membuat gambar yang dihasilkan menjadi deterministik. Menambahkan nomor seed dengan permintaan Anda adalah cara untuk memastikan bahwa Anda selalu mendapatkan gambar hasil yang sama. Misalnya, Anda dapat memberikan perintah, menetapkan jumlah hasil ke 1, dan menggunakan nomor seed untuk mendapatkan gambar yang sama setiap kali Anda menggunakan semua nilai input yang sama tersebut. Jika Anda mengirim permintaan yang sama dengan jumlah hasil yang ditetapkan ke 8, Anda akan mendapatkan delapan gambar yang sama. Namun, gambar tidak ditampilkan dalam urutan yang sama.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Nomor seed adalah kolom opsional dalam objek parameters dari isi permintaan JSON.

    1. Ikuti petunjuk buat gambar dengan teks untuk mengganti variabel isi permintaan lainnya.

    2. Ganti kode berikut:

      • SEED_NUMBER: bilangan bulat. Opsional. Bilangan bulat non-negatif yang Anda berikan untuk membuat gambar output menjadi deterministik. Memberikan nomor seed yang sama akan selalu menghasilkan gambar output yang sama. Jika model yang Anda gunakan mendukung watermark digital, Anda harus menyetel "addWatermark": false untuk menggunakan kolom ini. Nilai bilangan bulat yang diterima: 1 - 2147483647. 
      {
  "instances": [
    ...
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "seed": SEED_NUMBER,
    // required for model version 006 and greater only when using a seed number
    "addWatermark": false
  }
}

    3. Ikuti petunjuk membuat gambar dengan teks untuk mengirim permintaan REST Anda.

    Gaya yang telah ditentukan

    Gaya gambar yang ingin Anda buat. Anda dapat menggunakan fitur ini untuk membuat gambar dengan gaya populer seperti seni digital, cat air, atau cyberpunk.

    Konsol

    1. Ikuti petunjuk membuat gambar dengan teks untuk membuka Vertex AI Studio dan memasukkan perintah teks Anda.

    2. Di bagian Style pada panel Parameters, pilih gaya dari menu.

    3. Klik Generate.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Gaya yang telah ditentukan adalah kolom opsional dalam objek parameters dari isi permintaan JSON.

    1. Ikuti petunjuk buat gambar dengan teks untuk mengganti variabel isi permintaan lainnya.

    2. Ganti kode berikut:

      • IMAGE_STYLE: Salah satu gaya yang telah ditetapkan sebelumnya:
        • photograph
        • digital_art
        • landscape
        • sketch
        • watercolor
        • cyberpunk
        • pop_art
      {
  "instances": [
    ...
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT,
    "sampleImageStyle": "IMAGE_STYLE"
  }
}

    3. Ikuti petunjuk membuat gambar dengan teks untuk mengirim permintaan REST Anda.

    Meningkatkan skala gambar

    Gunakan peningkatan skala untuk meningkatkan ukuran gambar yang ada, dihasilkan, atau diedit tanpa menurunkan kualitas.

    Konsol

    1. Di Google Cloud konsol, buka halaman Vertex AI Studio > Media Studio.

      Buka Media Studio

    2. Klik Gambar.

    3. Di kotak Tulis perintah Anda, masukkan perintah teks yang menjelaskan gambar yang akan dibuat.

    4. Klik Buat.

    5. Klik gambar untuk meningkatkan skalanya.

      Panel Gambar akan ditampilkan.

    6. Klik download Ekspor gambar.

      Dialog Export image akan ditampilkan.

    7. Klik Juga tingkatkan kualitas gambar, lalu pilih Faktor skala.

    8. Untuk mendownload gambar yang ditingkatkan skalanya, klik Ekspor.

    REST

    Untuk mengetahui informasi selengkapnya tentang permintaan model imagegeneration, lihat referensi API model imagegeneration.

    Mode peningkatan skala adalah kolom opsional dalam objek parameters dari isi permintaan JSON. Saat Anda meningkatkan skala gambar menggunakan API, tentukan "mode": "upscale" dan upscaleConfig.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • LOCATION: Region project Anda. Misalnya, us-central1, europe-west2, atau asia-northeast3. Untuk mengetahui daftar region yang tersedia, lihat Lokasi AI Generatif di Vertex AI.
    • PROJECT_ID: Google Cloud Project ID Anda.
    • B64_BASE_IMAGE: Gambar dasar yang akan diedit atau di-upscale. Gambar harus ditentukan sebagai string byte berenkode base64. Batas ukuran: 10 MB.
    • IMAGE_SOURCE: Lokasi Cloud Storage gambar yang ingin Anda edit atau tingkatkan kualitasnya. Contoh: gs://output-bucket/source-photos/photo.png.
    • UPSCALE_FACTOR: Opsional. Faktor peningkatan skala gambar. Jika tidak ditentukan, faktor peningkatan kualitas akan ditentukan dari sisi terpanjang gambar input dan sampleImageSize. Nilai yang tersedia: x2 atau x4 .

    Metode HTTP dan URL: 

    POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@002:predict

    Isi JSON permintaan: 

    {
  "instances": [
    {
      "prompt": "",
      "image": {
        // use one of the following to specify the image to upscale
        "bytesBase64Encoded": "B64_BASE_IMAGE"
        "gcsUri": "IMAGE_SOURCE"
        // end of base image input options
      },
    }
  ],
  "parameters": {
    "sampleCount": 1,
    "mode": "upscale",
    "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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@002: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://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagegeneration@002:predict" | Select-Object -Expand Content

    Anda akan melihat respons JSON yang mirip dengan berikut ini:

    {
  "predictions": [
    {
      "mimeType": "image/png",
      "bytesBase64Encoded": "iVBOR..[base64-encoded-upscaled-image]...YII="
    }
  ]
}

    Langkah berikutnya

    Baca artikel tentang Imagen dan produk AI Generatif lainnya di Vertex AI:

    Sebelumnya
    Ringkasan Imagen
    Berikutnya
    Buat gambar