Class ControlReferenceImage (1.95.1)
Note: Some or all of the information on this page might not apply
to Trusted Cloud. For a list of services that are available in
Trusted Cloud, see Services available for
Trusted Cloud .
Version latestkeyboard_arrow_down
ControlReferenceImage (
reference_id ,
image : typing . Optional [
typing . Union [ bytes , vertexai . vision_models . Image , str ]
] = None ,
control_type : typing . Optional [
typing . Literal [ "default" , "scribble" , "face_mesh" , "canny" ]
] = None ,
enable_control_image_computation : typing . Optional [ bool ] = False ,
)
Control reference image.
This encapsulates the control reference image type.
Methods
ControlReferenceImage
ControlReferenceImage (
reference_id ,
image : typing . Optional [
typing . Union [ bytes , vertexai . vision_models . Image , str ]
] = None ,
control_type : typing . Optional [
typing . Literal [ "default" , "scribble" , "face_mesh" , "canny" ]
] = None ,
enable_control_image_computation : typing . Optional [ bool ] = False ,
)
Creates a ControlReferenceImage
object.
Parameters
Name
Description
image
typing.Union[bytes, vertexai.vision_models.Image , str, NoneType]
Either Image object or Image file bytes. Image can be in PNG or JPEG format.
control_type
typing.Optional[typing.Literal['default', 'scribble', 'face_mesh', 'canny']]
Control type for the image. Can take the following values: * default: Default control type * scribble: Scribble control type * face_mesh: Face mesh control type * canny: Canny control type
enable_control_image_computation
typing.Optional[bool]
When set to True, the control image will be computed by the model based on the control type. When set to False, the control image will be provided by the user.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class ControlReferenceImage (1.95.1)\n\nVersion latestkeyboard_arrow_down\n\n- [1.95.1 (latest)](/python/docs/reference/vertexai/latest/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.94.0](/python/docs/reference/vertexai/1.94.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.93.1](/python/docs/reference/vertexai/1.93.1/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.92.0](/python/docs/reference/vertexai/1.92.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.91.0](/python/docs/reference/vertexai/1.91.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.90.0](/python/docs/reference/vertexai/1.90.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.89.0](/python/docs/reference/vertexai/1.89.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.88.0](/python/docs/reference/vertexai/1.88.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.87.0](/python/docs/reference/vertexai/1.87.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.86.0](/python/docs/reference/vertexai/1.86.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.85.0](/python/docs/reference/vertexai/1.85.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.84.0](/python/docs/reference/vertexai/1.84.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.83.0](/python/docs/reference/vertexai/1.83.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.82.0](/python/docs/reference/vertexai/1.82.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.81.0](/python/docs/reference/vertexai/1.81.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.80.0](/python/docs/reference/vertexai/1.80.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.79.0](/python/docs/reference/vertexai/1.79.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.78.0](/python/docs/reference/vertexai/1.78.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.77.0](/python/docs/reference/vertexai/1.77.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.76.0](/python/docs/reference/vertexai/1.76.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.75.0](/python/docs/reference/vertexai/1.75.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.74.0](/python/docs/reference/vertexai/1.74.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.73.0](/python/docs/reference/vertexai/1.73.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.72.0](/python/docs/reference/vertexai/1.72.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.71.1](/python/docs/reference/vertexai/1.71.1/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.70.0](/python/docs/reference/vertexai/1.70.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.69.0](/python/docs/reference/vertexai/1.69.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.68.0](/python/docs/reference/vertexai/1.68.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.67.1](/python/docs/reference/vertexai/1.67.1/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.66.0](/python/docs/reference/vertexai/1.66.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.65.0](/python/docs/reference/vertexai/1.65.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.63.0](/python/docs/reference/vertexai/1.63.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.62.0](/python/docs/reference/vertexai/1.62.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.60.0](/python/docs/reference/vertexai/1.60.0/vertexai.preview.vision_models.ControlReferenceImage)\n- [1.59.0](/python/docs/reference/vertexai/1.59.0/vertexai.preview.vision_models.ControlReferenceImage) \n\n ControlReferenceImage(\n reference_id,\n image: typing.Optional[\n typing.Union[bytes, vertexai.vision_models.Image, str]\n ] = None,\n control_type: typing.Optional[\n typing.Literal[\"default\", \"scribble\", \"face_mesh\", \"canny\"]\n ] = None,\n enable_control_image_computation: typing.Optional[bool] = False,\n )\n\nControl reference image.\n\nThis encapsulates the control reference image type.\n\nMethods\n-------\n\n### ControlReferenceImage\n\n ControlReferenceImage(\n reference_id,\n image: typing.Optional[\n typing.Union[bytes, vertexai.vision_models.Image, str]\n ] = None,\n control_type: typing.Optional[\n typing.Literal[\"default\", \"scribble\", \"face_mesh\", \"canny\"]\n ] = None,\n enable_control_image_computation: typing.Optional[bool] = False,\n )\n\nCreates a `ControlReferenceImage` object."]]