Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 Search Documentation | 2026.1

# Connect an image tagging model

You can connect an image tagging model to P4 Search and configure it. You can only connect one image-tagging model at a time.

You must agree to P4 Search's terms to access a third-party service in P4 Search. See Bring your own key for P4 Search.

To learn more about setting configurables manually, see Configure P4 Search locally.

## Set up auto-tagging with Azure Tags

1. Set the auto-tagging model to AzureTagsModel:

   com.perforce.p4search.auto-detect.model=AzureTagsModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=https://my.cognitiveservices.azure.com

3. Enter the API key for your auto-tagging service. For example:

   com.perforce.p4search.auto-detect.key=0123456789ABCDEF0123456789ABCDEF

4. Specify the language for the image tags to be generated in. See your auto-tagging service documentation for supported languages. For example:

   com.perforce.p4search.auto-detect.lang=en

5. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.1=10%:

   com.perforce.p4search.auto-detect.threshold=0.1

6. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=AzureTagsModel
    com.perforce.p4search.auto-detect.host=https://my.cognitiveservices.azure.com
    com.perforce.p4search.auto-detect.key=0123456789ABCDEF0123456789ABCDEF
    com.perforce.p4search.auto-detect.lang=en
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10

## Set up auto-tagging with Rekognition Labels

1. Set the auto-tagging model to RekognitionLabelsModel:

   com.perforce.p4search.auto-detect.model=RekognitionLabelsModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=us-east-2

3. Enter the API key for your auto-tagging service. The API key for the AWS Rekognition is a combination of <aws_access_key_id> and <aws_secret_access_key>. For example:

   com.perforce.p4search.auto-detect.key=<aws_access_key_id>:<aws_secret_access_key>

   where

   ws_access_key_id=ABCDEFGHIJKL12345678

   ws_secret_access_key=ab0cd1ef2gh3IJ4aaaBBBcccWWW111rfc1234YERTpp

   gives

   com.perforce.p4search.auto-detect.key=ABCDEFGHIJKL12345678:ab0cd1ef2gh3IJ4aaaBBBcccWWW111rfc1234YERTpp

4. Specify the language for the image tags to be generated in. See your auto-tagging service documentation for supported languages. For example:

   com.perforce.p4search.auto-detect.lang=en

5. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.1=10%:

   com.perforce.p4search.auto-detect.threshold=0.1

6. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=RekognitionLabelsModel
    com.perforce.p4search.auto-detect.host=us-east-2
    com.perforce.p4search.auto-detect.key=ABCDEFGHIJKL12345678:ab0cd1ef2gh3IJ4aaaBBBcccWWW111rfc1234YERTpp
    com.perforce.p4search.auto-detect.lang=en
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10

## Set up auto-tagging with Google Labels

1. Set the auto-tagging model to GoogleLabelModel:

   com.perforce.p4search.auto-detect.model=GoogleLabelModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=https://vision.googleapis.com

3. Enter the API key for your auto-tagging service. For example:

   com.perforce.p4search.auto-detect.key=AbcdEFG12345ZXvfe56210QWErtyui123456789

4. Specify the language for the image tags to be generated in. See your auto-tagging service documentation for supported languages. For example:

   com.perforce.p4search.auto-detect.lang=en

5. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.1=10%:

   com.perforce.p4search.auto-detect.threshold=0.1

6. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=GoogleLabelModel
    com.perforce.p4search.auto-detect.host=https://vision.googleapis.com
    com.perforce.p4search.auto-detect.key=AbcdEFG12345ZXvfe56210QWErtyui123456789
    com.perforce.p4search.auto-detect.lang=en
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10

## Set up auto-tagging with OpenAI

1. Set the auto-tagging model to OpenAiDetectModel:

   com.perforce.p4search.auto-detect.model=OpenAiDetectModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=https://api.openai.com

3. Enter the API key for your auto-tagging service. For example:

   com.perforce.p4search.auto-detect.key=proj-5X5ZtGcP8FRGCYOW9j5FAaA2anqLxBP9cYIS-GKllRZJEbjgL61VkiJ3A7Aug5MZPk0y7_izVtT5BlbkFJ7h4RMyvmUvf38ePc6zCQZYGry9imQyStWc02eC2yqorQVvqORwDblqwdabyJWnHIrm80JXAAAA

4. Specify the classification service to use for image tags. For example, `gpt-5-nano` if you are using the GPT 5 Nano model:

   com.perforce.p4search.auto-detect.service=gpt-5-nano

5. Specify the language for the image tags to be generated in. See your auto-tagging service documentation for supported languages. For example:

   com.perforce.p4search.auto-detect.lang=korean,chinese

6. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.6=60%:

   com.perforce.p4search.auto-detect.threshold=0.6

7. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

8. Specify the query to use when tagging images. For example:

   com.perforce.p4search.auto-detect.query="Identify objects in the image"

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=OpenAiDetectModel
    com.perforce.p4search.auto-detect.host=https://api.openai.com
    com.perforce.p4search.auto-detect.lang=korean,chinese
    com.perforce.p4search.auto-detect.key=AbcdEFG12345ZXvfe56210QWErtyui123456789
    com.perforce.p4search.auto-detect.service=gpt-5-nano
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10
    com.perforce.p4search.auto-detect.query="Identify the objects in the image"

## Set up auto-tagging with P4 Detect

Before you can connect to P4 Detect, you must install and configure it. See Install P4 Detect and Configure P4 Detect.

1. Set the auto-tagging model to ClipModel:

   com.perforce.p4search.auto-detect.model=ClipModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=https://localhost:1608

3. Enter the X-Auth-Token for your auto-tagging service. For example:

   com.perforce.p4search.auto-detect.key=00000000-0000-0000-0000-000000000000

4. Specify the classification service to use for image tags. For example, clip_model if you are using OpenAI's CLIP model:

   com.perforce.p4search.auto-detect.service=clip_model

5. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.1=10%:

   com.perforce.p4search.auto-detect.threshold=0.6

6. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=ClipModel
    com.perforce.p4search.auto-detect.host=https://localhost:1608
    com.perforce.p4search.auto-detect.key=00000000-0000-0000-0000-000000000000
    com.perforce.p4search.auto-detect.service=clip_model
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10

## Set up auto-tagging with DeepDetect

1. Set the auto-tagging model to DeepDetectModel:

   com.perforce.p4search.auto-detect.model=DeepDetectModel

2. Specify the auto-tagging service hostname. For example:

   com.perforce.p4search.auto-detect.host=https://localhost:8888

3. DeepDetect does not support an API key. Leave empty (the default):

   com.perforce.p4search.auto-detect.key=

4. Specify the classification service to use for image tags. For example, classification_21k if you are using the DeepDetect 21k model:

   com.perforce.p4search.auto-detect.service=classification_21k

5. Specify the language for the image tags to be generated in. DeepDetect does not support multiple languages. In this case, leave it empty:

   com.perforce.p4search.auto-detect.lang=

6. Specify the automatic image detection threshold for your auto-tagging service as a floating point percentage. For example, 0.1=10%:

   com.perforce.p4search.auto-detect.threshold=0.1

7. Specify the automatic best image detection results limit. Defaults to 10 results:

   com.perforce.p4search.auto-detect.best=10

Copy
All configurables:

    com.perforce.p4search.auto-detect.model=DeepDetectModel
    com.perforce.p4search.auto-detect.host=http://localhost:8888
    com.perforce.p4search.auto-detect.key=
    com.perforce.p4search.auto-detect.service=classification_21k
    com.perforce.p4search.auto-detect.lang=
    com.perforce.p4search.auto-detect.threshold=0.1
    com.perforce.p4search.auto-detect.best=10

To learn more about using a pretrained model, see DeepDetect's Setup of an image classifier.

Copy
Example curl request to load the DeepDetect 21k pretrained model:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    curl -H "Content-Type: application/x-www-form-urlencoded" -X PUT
     -d '{
     "description": "generic image classification service",
     "model": {
      "repository": "/opt/models/classification_21k",
      "init":"https://deepdetect.com/models/init/desktop/images/classification/classification_21k.tar.gz",
      "create_repository": true
     },
     "mllib": "caffe",
     "type": "supervised",
     "parameters": {
      "input": {
      "connector": "image"
      }
     }
    }' http://localhost:8888/services/classification_21k

Your search for returned results