自 2025 年 4 月 29 日起，Gemini 1.5 Pro 和 Gemini 1.5 Flash 模型將無法用於先前未使用這些模型的專案，包括新專案。詳情請參閱「模型版本和生命週期」。

本頁面由 Cloud Translation API 翻譯而成。

主旨自訂

注意：自 2025 年 6 月 24 日起，Imagen 第 1 版和第 2 版將淘汰。Imagen 模型 imagegeneration@002、imagegeneration@005 和 imagegeneration@006 將於 2025 年 9 月 24 日移除。如要進一步瞭解如何遷移至 Imagen 3，請參閱「遷移至 Imagen 3」。

Imagen 3 的主體自訂功能可根據文字提示和您提供的參考圖片，生成新圖片。您提供的參考圖片有助於引導生成新圖片。

用途

Imagen 3 Customization 提供自由式提示，因此可能會給人一種印象，以為它能執行的工作比訓練內容更多。以下各節將說明 Imagen 3 Customization 的預期用途，以及非預期用途的範例 (僅列舉部分)。

建議您針對預期用途使用 Imagen 3 Customization，因為我們已針對這些用途訓練模型，預期可獲得良好結果。反之，雖然您可以強迫模型執行預期用途以外的動作，但我們不保證能獲得良好結果。

目標用途

以下是 Imagen 3 Customization 主題自訂功能的適用用途：

為人物相片套用風格
為人物相片套用風格，並保留人物的臉部表情
(成功率低) 將產品 (例如沙發或餅乾) 放置在不同場景，並從不同角度拍攝。
生成產品的變體，但不會保留確切詳細資料
為人物相片套用風格，同時保留臉部表情

不當用途範例

以下列舉幾個 Imagen 3 自訂功能無法處理，且會產生不良結果的用途：

將兩位以上的人員放置在不同場景，同時保留身分
將兩個人以上放在不同場景，同時保留他們的身份，並使用範例圖片做為樣式輸入，指定輸出圖片的樣式。
為兩張以上的人像相片套用風格，同時保留人物身分
將寵物放入不同場景，同時保留其身分
將寵物相片轉換為手繪風格
將寵物相片轉換成手繪風格，同時保留或指定圖片風格 (例如水彩)
將寵物和人物分別放入不同場景，同時保留兩者的身分。
將寵物和一或多個人物的相片套用風格，並轉換成繪圖
將兩項產品放置在不同場景中，並從不同角度拍攝
將產品 (例如餅乾或沙發) 放置在不同場景中，並從不同角度拍攝，同時遵循特定圖片風格 (例如特定顏色、光線風格或動畫的擬真照片)
將產品放入不同場景，同時保留控制圖片指定的特定場景構圖
將兩項產品放置在不同場景，並從不同角度呈現產品，以特定圖片做為輸入內容 (例如具有特定色彩、光線風格或動畫的擬真圖片)
將兩項產品放置到不同場景，同時保留控制圖片指定的特定場景構圖

主旨自訂範例

以下各節說明 Imagen 3 Customization 支援的主體自訂案例：

個人化

輸入內容範例	輸出內容範例
參考圖片¹：文字提示：生成與以下描述相符的圖片：以 3D 卡通風格繪製的`woman with long hair[1]`肖像，背景模糊。`woman with long hair[1]`可愛迷人的角色，面帶微笑，看向鏡頭，粉彩色調，高品質，4K，傑作，超級細節，皮膚紋理，紋理對應，柔和陰影，柔和逼真的光線，鮮豔色彩。

¹ 使用 Imagen 3 生成的參考輸入圖片，提示為：巴黎女性肖像，她穿著黑褲和白襯衫。

產品自訂

輸入內容範例	輸出內容範例
參考圖片²：文字提示：生成 `perfume bottle [1]` 的圖像，但顏色為青色

² 使用 Imagen 3 生成的參考輸入圖片，提示為：perfume bottle product style image in front of a black background。

查看「Imagen for Editing and Customization」模型資訊卡

事前準備

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.

Go to project selector

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

Enable the Vertex AI API.

Enable the API

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

Go to project selector

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

Enable the Vertex AI API.

Enable the API

為環境設定驗證方法。

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.

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 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.

詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

自訂主旨

使用 Imagen 3 自訂功能時，您可以提供主體類型的參考圖片。具體來說，Imagen 3 Customization 的少樣本提示支援下列主體：產品、人物和寵物。選擇的主題會影響生成要求的形式。

使用 Imagen 3 自訂功能時，提示可能會影響生成的圖片品質。以下各節說明建議的提示範本和範例，可傳送自訂要求。

個人化

下表說明我們建議的提示範本，可做為撰寫人物自訂提示的起點：

用途	參考圖片	提示範本	範例
以臉部網格輸入內容為人物圖片套用風格	主體圖像 (1) 臉部網格控制圖像 (1)	使用`facemesh from the control image [2]`生成 `SUBJECT_DESCRIPTION [1]` 的圖片。${PROMPT}	使用 `facemesh from the control image [2]` 生成 `the person [1]` 的圖片。拍攝對象應面無表情地直視前方。背景應為 ...
不使用臉部網格輸入內容，為人物圖片套用風格	主體圖像 (1 到 4 張)	請根據以下說明，製作與 `SUBJECT_DESCRIPTION [1]` 相符的圖片：`SUBJECT_DESCRIPTION [1]` 的肖像照${PROMPT}	請根據以下說明製作「`a woman with short hair[1]`」的圖片：以 3D 卡通風格繪製「`a woman with short hair[1]`」的肖像，背景模糊處理。可愛的角色，笑臉，看著鏡頭，粉彩色調，高品質，4K，傑作，超級細節，皮膚紋理，紋理對應，柔和陰影，柔和的真實光線，鮮豔的色彩
不使用臉部網格輸入內容，為人物圖片套用風格	主體圖像 (1 到 4 張)	根據以下說明建立 `STYLE_DESCRIPTION [2]` 圖片：`SUBJECT_DESCRIPTION [1]` 的肖像，`SUBJECT_DESCRIPTION [1]` STYLE_PROMPT	請根據說明建立「`a woman with short hair [1]`」的 `3d-cartoon style [2]` 圖片：`a woman with short hair [1]` 的肖像，以 3D 卡通風格呈現，背景模糊。可愛的角色，笑臉，看著鏡頭，柔和色調，高品質，4K，傑作，超級細節，皮膚紋理，紋理對應，柔和陰影，柔和逼真的光線，鮮豔色彩
以臉部網格輸入內容為人物圖片套用風格	主體圖片 (1-3) 臉部網格控制圖片 (1)	以`SUBJECT_DESCRIPTION [1]`的姿勢建立`CONTROL_IMAGE [2]`圖片，符合以下說明：`SUBJECT_DESCRIPTION [1]`的肖像照 ${PROMPT}	根據說明，以「`control image [2]`」的姿勢繪製「`a woman with short hair [1]`」的圖片：3D 卡通風格的「`a woman with short hair [1]`」肖像，背景模糊。可愛的角色，笑臉。See the camera, pastel color tone, high quality, 4k, masterpiece, super details, skin texture, texture mapping, Soft shadows, soft realistic lighting, vibrant colors
以臉部網格輸入內容為人物圖片套用風格	主體圖片 (1-3) 臉部網格控制圖片 (1)	建立 `STYLE_DESCRIPTION [3]` 圖片，內容為 `SUBJECT_DESCRIPTION [1]`，姿勢為 `CONTROL_IMAGE [2]`，與說明相符： `SUBJECT_DESCRIPTION [1]` 的肖像 ${PROMPT}	請以 `control image [2]` 的姿勢，生成與以下說明相符的 `3d-cartoon style [3]` 圖片：`a woman with short hair [1]` 的 3D 卡通風格肖像，背景模糊。`a woman with short hair [1]`可愛又討喜的角色，面帶微笑。See the camera, pastel color tone, high quality, 4k, masterpiece, super details, skin texture, texture mapping, Soft shadows, soft realistic lighting, vibrant colors

建議參考圖片中的臉部具有下列特徵：

置中顯示，且至少占據整張圖片的一半
在正面視角中朝各個方向旋轉 (側滾、俯仰和偏擺)
未被太陽眼鏡或口罩等物品遮住

使用下列範例，傳送自訂要求和人物參考圖片，引導圖片生成。你可以傳送這類要求，並視需要提供臉部網格控制圖片，進一步引導圖片生成。

REST

如要進一步瞭解 imagen-3.0-capability-001 模型要求，請參閱 imagen-3.0-capability-001 模型 API 參考資料。

這個範例說明如何指定臉部網格控制區域來引導生成作業，但您也可以省略控制參照物件 ("referenceType": "REFERENCE_TYPE_CONTROL")，Imagen 會自動偵測臉部網格控制區域。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud 專案 ID。
LOCATION：專案的區域。例如 us-central1、europe-west2 或 asia-northeast3。如需可用區域的清單，請參閱「Vertex AI 的生成式 AI 服務地區」。
TEXT_PROMPT：文字提示會引導模型生成圖片。如要使用 Imagen 3 自訂功能，請在 [$referenceId] 格式中加入您提供的參考圖片 referenceId。例如：
- 以下文字提示適用於有兩張參照圖片的請求，且圖片具有 "referenceId": 1。兩張圖片都有選填的 "subjectDescription": "man with short hair" 說明。此外，還有以 "referenceId": 2 指定的控制臉部網格圖像：建立與控制圖像 [2] 姿勢相同的 man with short hair [1] 圖像，符合以下描述：以鉛筆風格繪製 man with short hair [1] 的全身肖像，並以交叉影線繪製、以 6B 和石墨鉛筆繪製肖像影線、白色背景、鉛筆繪圖、高品質、鉛筆筆觸、看著鏡頭、自然的人眼
"referenceId"：參考圖片的 ID，或對應相同主題或風格的一系列參考圖片 ID。在本範例中，兩張參照圖片都是同一個人，因此共用相同的 referenceId (1)，而控制臉部網格圖片則有不同的 referenceId (2)。生成的圖片會遵循從參照圖片擷取的臉部網格臉部結構，並改善臉部外觀。系統僅支援一個臉部網格控制項。
BASE64_REFERENCE_IMAGE：引導圖片生成的參考圖片。圖片必須指定為採用 base64 編碼的位元組字串。

SUBJECT_DESCRIPTION：選用。參考圖片的文字說明，可用於 prompt 欄位。例如：

      "prompt": "a full-body portrait of a man with short hair [1] with hatch-cross
      drawing",
      [...],
      "subjectDescription": "man with short hair"

IMAGE_COUNT：生成的圖片數量。接受的整數值：1 到 4。預設值：4。

HTTP 方法和網址：

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagen-3.0-capability-001:predict

JSON 要求主體：

{
  "instances": [
    {
      "prompt": "TEXT_PROMPT",
      "referenceImages": [

        {
          "referenceType": "REFERENCE_TYPE_SUBJECT",
          "referenceId": 1,
          "referenceImage": {
            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"
          },
          "subjectImageConfig": {
            "subjectDescription": "SUBJECT_DESCRIPTION",
            "subjectType": "SUBJECT_TYPE_PERSON"
          }
        },
        {
          "referenceType": "REFERENCE_TYPE_SUBJECT",
          "referenceId": 1,
          "referenceImage": {
            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"
          },
          "subjectImageConfig": {
            "subjectDescription": "SUBJECT_DESCRIPTION",
            "subjectType": "SUBJECT_TYPE_PERSON"
          }
        },
        {
          "referenceType": "REFERENCE_TYPE_CONTROL",
          "referenceId": 2,
          "referenceImage": {
            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"
          },
          "controlImageConfig": {
            "controlType": "CONTROL_TYPE_FACE_MESH",
            "enableControlImageComputation": true
          }
        }
      ]
    }
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 Cloud Shell，自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/imagen-3.0-capability-001:predict"

PowerShell

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/imagen-3.0-capability-001:predict" | Select-Object -Expand Content

以下是要求 "sampleCount": 2 的範例回應。回應會傳回兩個預測物件，其中包含以 base64 編碼的生成圖片位元組。

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

Python

from google import genai
from google.genai.types import (
    ControlReferenceConfig,
    ControlReferenceImage,
    EditImageConfig,
    Image,
    SubjectReferenceConfig,
    SubjectReferenceImage
)

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

# Create subject and control reference images of a photograph stored in Google Cloud Storage
# using https://storage.googleapis.com/cloud-samples-data/generative-ai/image/person.png
subject_reference_image = SubjectReferenceImage(
    reference_id=1,
    reference_image=Image(gcs_uri="gs://cloud-samples-data/generative-ai/image/person.png"),
    config=SubjectReferenceConfig(
        subject_description="a headshot of a woman", subject_type="SUBJECT_TYPE_PERSON"
    ),
)
control_reference_image = ControlReferenceImage(
    reference_id=2,
    reference_image=Image(gcs_uri="gs://cloud-samples-data/generative-ai/image/person.png"),
    config=ControlReferenceConfig(control_type="CONTROL_TYPE_FACE_MESH"),
)

image = client.models.edit_image(
    model="imagen-3.0-capability-001",
    prompt="""
    a portrait of a woman[1] in the pose of the control image[2]in a watercolor style by a professional artist,
    light and low-contrast stokes, bright pastel colors, a warm atmosphere, clean background, grainy paper,
    bold visible brushstrokes, patchy details
    """,
    reference_images=[subject_reference_image, control_reference_image],
    config=EditImageConfig(
        edit_mode="EDIT_MODE_DEFAULT",
        number_of_images=1,
        seed=1,
        safety_filter_level="BLOCK_MEDIUM_AND_ABOVE",
        person_generation="ALLOW_ADULT",
        output_gcs_uri=output_gcs_uri,
    ),
)

# Example response:
# gs://your-bucket/your-prefix
print(image.generated_images[0].image.gcs_uri)

產品自訂

下表說明我們建議的提示範本，可做為撰寫產品自訂提示的起點：

參考圖片	提示範本	範例
主體圖像 (1 到 4 張)	根據以下說明製作圖片：`SUBJECT_DESCRIPTION [1]`${PROMPT}${PROMPT}	根據以下說明建立圖片：特寫鏡頭，以高調風格呈現女性的手拿著 `Luxe Elixir hair oil, golden liquid in glass bottle [1]`，背景為純白色。`Luxe Elixir hair oil, golden liquid in glass bottle [1]`女子的手部光線充足，焦點清楚對準瓶身，淺景深效果模糊了背景，突顯產品。光線柔和且漫射，在瓶身和手上營造出微光。整體構圖簡單優雅，突顯產品的奢華魅力。
主體圖像 (1 到 4 張)	生成 `SUBJECT_DESCRIPTION` 的圖片，但 ${PROMPT}	生成`Seiko watch [1]`的圖片，但顏色為藍色。

使用下列範例傳送自訂要求，並提供產品參考圖片，引導圖片生成。

控制台

在 Google Cloud 控制台中，前往「Vertex AI」>「Media Studio」 頁面。
前往媒體工作室
在「Parameters」窗格的「Model」部分中，選取「Imagen 3」(如果尚未選取)。
(選用步驟) 選擇 1:1 (預設) 以外的顯示比例。
(選用步驟) 變更「結果數量」。
(選用步驟) 提供負面提示，引導模型避免生成特定內容。
(選用步驟) 變更任何「進階選項」。
在「文字提示」欄位 (「輸入提示...」) 中，按一下「新增參考資料」。
1. 在「新增參照」窗格中，選擇「參照類型」： Subject - product。
2. 在「參考圖片」部分中，按一下「上傳」
3. 選擇儲存在本機的圖片，然後按一下「開啟」。
4. (選用步驟) 提供參考圖片的說明。
5. 按一下 [完成]。
6. (選用步驟) 如要新增更多參考圖片，請按一下「新增圖片」並上傳其他圖片。
7. 新增所有參考圖像後，按一下「新增參考」。
  您在該窗格中新增的所有參考圖片，參考編號都相同。新增文字提示時，請使用這個參照編號。
在「文字提示」欄位 (「撰寫提示...」)，加入包含參考圖片參考編號的文字提示。例如：
1. 明亮的白色房間，玻璃桌上放著 product [1]
2. animal [1]站在廣闊的田野上，遠處是森林
3. person [1]在film noir style [2]城市街道上的黑白人像照

REST

如要進一步瞭解 imagen-3.0-capability-001 模型要求，請參閱 imagen-3.0-capability-001 模型 API 參考資料。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud 專案 ID。
LOCATION：專案的區域。例如 us-central1、europe-west2 或 asia-northeast3。如需可用區域的清單，請參閱「Vertex AI 的生成式 AI 服務地區」。
TEXT_PROMPT：文字提示會引導模型生成圖片。如要使用 Imagen 3 自訂功能，請在 [$referenceId] 格式中加入您提供的參考圖片 referenceId。例如：
- 根據Luxe Elixir hair oil, golden liquid in glass bottle [1]建立圖片，以符合以下說明：特寫的高調圖片，顯示女性的手拿著Luxe Elixir hair oil, golden liquid in glass bottle [1]，背景為純白色。女子的手部光線充足，焦點清楚對準瓶子，淺景深模糊了背景，突顯產品。
"referenceId"：參考圖片的 ID，或對應相同主題或風格的一系列參考圖片 ID。在這個範例中，兩張參照圖片都是同一項產品，因此共用相同的 referenceId (1)。
BASE64_REFERENCE_IMAGE：引導圖片生成的參考圖片。圖片必須指定為採用 base64 編碼的位元組字串。

SUBJECT_DESCRIPTION：選用。參考圖片的文字說明，可用於 prompt 欄位。例如：

      "prompt": "Luxe Elixir hair oil, golden liquid in glass bottle [1]
       against a pure white background.",
      [...],
      "subjectDescription": "Luxe Elixir hair oil, golden liquid in glass bottle"

IMAGE_COUNT：生成的圖片數量。接受的整數值：1 到 4。預設值：4。

HTTP 方法和網址：

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/imagen-3.0-capability-001:predict

JSON 要求主體：

{
  "instances": [
    {
      "prompt": "TEXT_PROMPT",
      "referenceImages": [
        {
          "referenceType": "REFERENCE_TYPE_SUBJECT",
          "referenceId": 1,
          "referenceImage": {
            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"
          },
          "subjectImageConfig": {
            "subjectType": "SUBJECT_TYPE_PRODUCT",
            "subjectDescription": "SUBJECT_DESCRIPTION"
          }
        },
        {
          "referenceType": "REFERENCE_TYPE_SUBJECT",
          "referenceId": 1,
          "referenceImage": {
            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"
          },
          "subjectImageConfig": {
            "subjectType": "SUBJECT_TYPE_PRODUCT",
            "subjectDescription": "SUBJECT_DESCRIPTION"
          }
        }
      ]
    }
  ],
  "parameters": {
    "sampleCount": IMAGE_COUNT
  }
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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/imagen-3.0-capability-001:predict"

PowerShell

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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/imagen-3.0-capability-001:predict" | Select-Object -Expand Content

以下是要求 "sampleCount": 2 的範例回應。回應會傳回兩個預測物件，其中包含以 base64 編碼的生成圖片位元組。

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

產品使用量累進區間

如要查看與 Vertex AI 上的 Imagen 相關聯的使用標準和內容限制，請參閱使用指南。

模型版本

你可以使用多種圖片生成模型。詳情請參閱「Imagen 模型」。

後續步驟

閱讀有關 Imagen 和其他 Vertex AI 生成式 AI 產品的文章：

主旨自訂 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

用途

目標用途

不當用途範例

主旨自訂範例

個人化

產品自訂

事前準備

Console

REST

自訂主旨

個人化

REST

curl

PowerShell

Python

產品自訂

控制台

REST

curl

PowerShell

產品使用量累進區間

模型版本

後續步驟

主旨自訂