Show Menu
TEMAS×

Similitud visual

Content and Commerce AI está en versión beta. La documentación está sujeta a cambios.
El servicio de similitud visual, cuando se le proporciona una imagen, busca automáticamente imágenes visualmente similares de un catálogo.
En la solicitud de ejemplo mostrada en este documento se utilizó la siguiente imagen:
Formato API
POST /services/v1/predict

Solicitud
La siguiente solicitud recupera imágenes visualmente similares de un catálogo, según los parámetros de entrada proporcionados en la carga útil. Consulte la tabla debajo de la carga útil de ejemplo para obtener más información sobre los parámetros de entrada mostrados.
analyzer_id determina qué Sensei Content Framework se utiliza. Verifique que dispone de la información adecuada analyzer_id antes de realizar su solicitud. Póngase en contacto con el equipo beta de Content and Commerce AI para recibir su analyzer_id solicitud de este servicio.
curl -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H 'Authorization: Bearer $API_TOKEN' \
  -H 'Content-Type: multipart/form-data' \
  -H 'cache-control: no-cache,no-cache' \
  -H 'x-api-key: $API_KEY' \
  -F file=@test_image.jpg \
  -F 'contentAnalyzerRequests={
   "enable_diagnostics":"true",
   "requests":[
     {
         "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
         "parameters": {
          "application-id": "1234", 
          "content-type": "inline", 
          "encoding": "jpeg", 
          "threshold": "0", 
          "top-N": "0", 
          "custom": {}, 
          "data": [{
            "content-id": "0987", 
            "content": "inline-image", 
            "content-type": "inline", 
            "encoding": "jpeg", 
            "threshold": "0", 
            "top-N": "0", 
            "historic-metadata": [], 
            "custom": {}
            }]
          }
      }
    ]
}'

Propiedad
Descripción
Obligatorio
analyzer_id
ID del Sensei servicio en el que se implementa la solicitud. Este ID determina cuál de los Sensei Content Frameworks se utiliza. Para obtener servicios personalizados, póngase en contacto con el equipo de Content and Commerce AI para configurar un ID personalizado.
application-id
ID de la aplicación creada.
data
Matriz que contiene un objeto JSON con cada objeto de la matriz que representa una imagen. Cualquier parámetro pasado como parte de esta matriz anula los parámetros globales especificados fuera de la data matriz. Cualquiera de las propiedades restantes que se describen a continuación en esta tabla se puede sobrescribir desde dentro data .
content-id
ID única para el elemento de datos que se devuelve en la respuesta. Si no se pasa, se asigna un ID generado automáticamente.
No
content
El contenido que analizará el servicio de similitud visual. En el evento de que la imagen forma parte del cuerpo de la solicitud, utilice -F file=@<filename> el comando curl para pasar la imagen, dejando este parámetro como una cadena vacía.
Si la imagen es un archivo en S3, pase la dirección URL firmada. Cuando el contenido forma parte del cuerpo de la solicitud, la lista de los elementos de datos debe tener un solo objeto. Si se pasa más de un objeto, solo se procesa el primer objeto.
content-type
Se utiliza para indicar si la entrada es parte del cuerpo de la solicitud o una dirección URL firmada para un bucket S3. El valor predeterminado de esta propiedad es inline .
No
encoding
Formato de archivo de la imagen de entrada. Actualmente solo se pueden procesar imágenes JPEG y PNG. El valor predeterminado de esta propiedad es jpeg .
No
threshold
El umbral de puntuación (0 a 1) por encima del cual deben devolverse los resultados. Utilice el valor 0 para devolver todos los resultados. El valor predeterminado de esta propiedad es 0 .
No
top-N
Número de resultados que se van a devolver (no puede ser un entero negativo). Utilice el valor 0 para devolver todos los resultados. Cuando se utiliza junto con threshold , el número de resultados devueltos es el menor de cualquiera de los límites establecidos. El valor predeterminado de esta propiedad es 0 .
No
custom
Parámetros personalizados que se van a pasar.
No
historic-metadata
Matriz que puede pasarse a los metadatos.
No
Respuesta
Una respuesta correcta devuelve una response matriz que contiene una feature_value y feature_name para cada una de las imágenes visualmente similares encontradas en el catálogo.
En la respuesta de ejemplo que se muestra a continuación se devolvieron las siguientes imágenes visualmente similares:
{
  "status": 200,
  "content_id": "test_image.jpg",
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
      "content_id": "test_image.jpg",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_value": [
              {
                "feature_value": "678",
                "feature_name": "G34WS945.F1"
              },
              {
                "feature_value": "678",
                "feature_name": "1431RDM JANELLE RAW JACKE"
              },
              {
                "feature_value": "657",
                "feature_name": "GF4045877841 CARLA FLR"
              },
              {
                "feature_name": "1707-686-SGU PATCH XYZ",
                "feature_value": "657"
              },
              {
                "feature_name": "5495MJT AJA BLK",
                "feature_value": "646"
              },
              {
                "feature_name": "IDEAL",
                "feature_value": "645"
              },
              {
                "feature_value": "644",
                "feature_name": "HCAJRA439 CALI JEAN"
              },
              {
                "feature_name": "KT279RK-ONL",
                "feature_value": "644"
              },
              {
                "feature_name": "SP190404-ELLIS",
                "feature_value": "642"
              },
              {
                "feature_name": "GF4174848718 KENDALL DIS",
                "feature_value": "640"
              }
            ],
            "feature_name": "visual_similarity"
          }
        ]
      }
    }
  ],
  "error": []
}