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 del analyzer_id
apropiado antes de realizar su solicitud. Póngase en contacto con el equipo beta de Content and Commerce AI para recibir su analyzer_id
para 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 |
El identificador de servicio Sensei en el que se implementa su 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. | Sí |
application-id |
ID de la aplicación creada. | Sí |
data |
Matriz que contiene un objeto JSON con cada objeto de la matriz que representa una imagen. Cualquier parámetro que se pase como parte de esta matriz anula los parámetros globales especificados fuera de la matriz data . Cualquiera de las propiedades restantes que se describen a continuación en esta tabla se puede sobrescribir desde data . |
Sí |
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> en 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. |
Sí |
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. Use 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). Use el valor 0 para devolver todos los resultados. Cuando se utiliza junto con threshold , el número de resultados devueltos es el menor 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 matriz response
que contiene feature_value
y feature_name
para cada una de las imágenes visualmente similares que se encuentran 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": []
}