REST

Before using any of the request data, make the following replacements:

• PROJECT_ID: Your Google Cloudproject ID.
• LOCATION: Your project's region. For example,us-central1,europe-west2, orasia-northeast3. For a list of available regions, seeGenerative AI on Vertex AI locations.
• TEXT_PROMPT: The text prompt guides what images the model generates. To use Imagen 3 Customization, include thereferenceId of the reference image or images you provide in the format[$referenceId]. For example:
  • Transform the subject in image[1] to have a Digital Stained Glass style image style.
  • Add a red cowboy hat to the cat in the image[1].
  • Remove the corgi dog in the image[1].
  • Change the red ball in the image[1] to a blue box.
• "referenceId": The ID of the reference image, or the ID for a series of reference images that correspond to the same subject or style.
• BASE64_REFERENCE_IMAGE: A reference image to guide image generation. The image must be specified as abase64-encoded byte string.
• IMAGE_COUNT: The number of generated images. Accepted integer values: 1-4. Default value: 4.

HTTP method and URL:

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

Request JSON body:

{  "instances": [    {      "prompt": "TEXT_PROMPT",      "referenceImages": [        {          "referenceType": "REFERENCE_TYPE_RAW",          "referenceId":1,          "referenceImage": {            "bytesBase64Encoded": "BASE64_REFERENCE_IMAGE"          }        }      ]    }  ],  "parameters": {    "sampleCount":IMAGE_COUNT  }}

To send your request, choose one of these options:

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"

$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

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