Similaridade visual

OBSERVAÇÃO

Content and Commerce AI está em beta. A documentação está sujeita a alterações.

O serviço de similaridade visual, ao receber uma imagem, encontra automaticamente imagens visualmente semelhantes de um catálogo.

A imagem a seguir foi usada na solicitação de exemplo mostrada neste documento:

imagem de teste

Formato da API

POST /services/v1/predict

Solicitação

A solicitação a seguir recupera imagens visualmente semelhantes de um catálogo, com base nos parâmetros de entrada fornecidos no payload. Consulte a tabela abaixo do exemplo de carga para obter mais informações sobre os parâmetros de entrada mostrados.

ATENÇÃO

analyzer_id determina qual Sensei Content Framework é usada. Verifique se você tem o analyzer_id correto antes de fazer sua solicitação. Entre em contato com a equipe beta do Content and Commerce AI para receber seu analyzer_id para este serviço.

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": {}
            }]
          }
      }
    ]
}'
Propriedade Descrição Obrigatório
analyzer_id A ID do serviço Sensei em que sua solicitação é implantada. Essa ID determina qual das Sensei Content Frameworks é usada. Para serviços personalizados, entre em contato com a equipe de API de Conteúdo e Comércio para configurar uma ID personalizada. Sim
application-id A ID do aplicativo criado. Sim
data Uma matriz que contém um objeto JSON com cada objeto na matriz que representa uma imagem. Qualquer parâmetro passado como parte dessa matriz substitui os parâmetros globais especificados fora da matriz data. Qualquer uma das propriedades restantes descritas abaixo nesta tabela pode ser substituída de dentro de data. Sim
content-id A ID exclusiva para o elemento de dados retornado na resposta. Se isso não for passado, uma ID gerada automaticamente será atribuída. Não
content O conteúdo a ser analisado pelo serviço de semelhança visual. Caso a imagem faça parte do corpo da solicitação, use -F file=@<filename> no comando curl para passar a imagem, deixando esse parâmetro como uma string vazia.
Se a imagem for um arquivo no S3, passe o url assinado. Quando o conteúdo faz parte do corpo da solicitação, a lista de elementos de dados deve ter apenas um objeto. Se mais de um objeto for transmitido, somente o primeiro objeto será processado.
Sim
content-type Usado para indicar se a entrada é parte do corpo da solicitação ou um url assinado para um bucket S3. O padrão para essa propriedade é inline. Não
encoding O formato de arquivo da imagem de entrada. Atualmente, somente imagens JPEG e PNG podem ser processadas. O padrão para essa propriedade é jpeg. Não
threshold O limite de pontuação (0 a 1) acima do qual os resultados precisam ser retornados. Use o valor 0 para retornar todos os resultados. O padrão para essa propriedade é 0. Não
top-N O número de resultados a serem retornados (não pode ser um número inteiro negativo). Use o valor 0 para retornar todos os resultados. Quando usado em conjunto com threshold, o número de resultados retornados é o menor de qualquer um dos limites definidos. O padrão para essa propriedade é 0. Não
custom Quaisquer parâmetros personalizados a serem transmitidos. Não
historic-metadata Uma matriz que pode receber metadados. Não

Resposta

Uma resposta bem-sucedida retorna uma matriz response que contém feature_value e feature_name para cada uma das imagens visualmente semelhantes encontradas no catálogo.

As imagens visualmente semelhantes a seguir foram retornadas na resposta de exemplo mostrada abaixo:

imagens semelhantes

{
  "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": []
}

Nesta página