Tous les produits
Search
Centre de documentation

Image Search:Condition de filtre

Dernière mise à jour :Oct 09, 2026

Dans Image Search, utilisez une condition de filtre pour ne renvoyer que les images correspondant à vos critères. Par exemple, vous pouvez récupérer les images dont l'ownerId est 1000 ou dont le nom de l'entreprise est 'alibaba'.

Paramètres des champs

Lors de l'ajout d'une image, configurez huit champs d'attribut : IntAttr, IntAttr2, IntAttr3, IntAttr4, StrAttr, StrAttr2, StrAttr3 et StrAttr4. Ces champs comprennent quatre attributs entiers et quatre attributs de chaîne, utilisés pour filtrer les images lors d'une recherche. Image Search prend en charge plusieurs méthodes d'ajout d'images. Les exemples suivants illustrent la configuration de ces attributs pour chaque méthode.

  • Ajoutez des images par lot. Pour plus d'informations, consultez la rubrique Opérations par lot.

    {"OperationType": "ADD","ProductId": "1000","CategoryId": 0,"IntAttr": 123,"IntAttr2": 135,"StrAttr": "value1","StrAttr2": "value2","IntAttr3": 3,"StrAttr4": "value4","CustomContent": "k1:v1,k2:v2,k3:v3","PicName": "girl_cloth1.jpg"}
  • Ajoutez des images à l'aide du SDK. Pour plus d'informations, consultez l'API Add.

  • Ajoutez des images via la console.

    Sur la page Add Image de la console, définissez les valeurs des attributs IntAttr, IntAttr2, IntAttr3, IntAttr4, StrAttr, StrAttr2, StrAttr3 et StrAttr4. Renseignez les champs suivants : Product ID (par exemple, 1), Image Name (par exemple, 1.jpg) et Upload Image. Activez l'option Object Detection et définissez le Object Detection Mode sur Auto. Spécifiez ensuite la Image Category, le Custom Content, l'Integer Attribute (par exemple, 1000), le String Attribute (par exemple, str2345), l'Integer Attribute 2 (par exemple, 200) et le String Attribute 2 (par exemple, str9999). Une fois terminé, cliquez sur Confirm. En cas de succès, la réponse renvoie un objet JSON où le champ code a la valeur 0, le champ message contient success et le champ statusCode indique 200. La réponse inclut également les champs categoryId et region dans l'objet picInfo.

Filtrage par champ

Lors d'une recherche, spécifiez une condition de filtre pour affiner les résultats. Combinez plusieurs conditions à l'aide des opérateurs logiques AND ou OR.

  • Les opérateurs suivants sont pris en charge pour int_attr, int_attr2, int_attr3 et int_attr4 :

    • >

    • >=

    • <

    • <=

    • =

    • in

    • not in

  • Les opérateurs suivants sont pris en charge pour str_attr, str_attr2, str_attr3 et str_attr4 :

    • =

    • !=

    • in

    • not in

Lorsque vous combinez AND et OR dans une même condition de filtre, les opérateurs respectent les règles de priorité suivantes :

  • AND a une priorité supérieure à OR. L'expression int_attr=100 AND str_attr="value1" OR int_attr=200 est évaluée comme suit : (int_attr=100 AND str_attr="value1") OR int_attr=200.

  • Les parenthèses () ont la priorité la plus élevée. L'expression située entre parenthèses est évaluée en premier, puis le résultat est combiné avec les conditions situées à l'extérieur des parenthèses.

Par exemple, pour rechercher des images dont int_attr est égal à 100 ou 200, et dont str_attr est égal à value1, utilisez des parenthèses pour regrouper la condition OR :

(int_attr=100 OR int_attr=200) AND str_attr="value1"

Exemples :

int_attr>=100
str_attr!="value1"
int_attr=1000 AND str_attr="value1"
int_attr = 1000 AND  int_attr2 = 200 AND str_attr = "str2345" AND str_attr2="str9999"
  • Effectuez une recherche via une API. Pour plus d'informations, consultez les Paramètres de requête.

    Définissez le paramètre filter dans votre requête API avec la condition de filtre souhaitée.

  • Effectuez une recherche à l'aide du SDK. Pour plus d'informations, consultez l'API SearchImageByPic.

    Appelez la méthode setFilterClause de la classe SearchItemRequest pour définir la condition de filtre.

  • Effectuez une recherche via la console.

    Définissez la Filter condition en vous basant sur les exemples précédents. Dans l'onglet Image Search, sélectionnez SearchByPic comme type de recherche, téléchargez l'image à rechercher et activez la détection d'objets (mode de détection : Auto). Définissez le nombre de résultats sur 10 et la position de départ sur 0. Dans la zone de saisie Filter condition, entrez votre expression de filtre, par exemple int_attr = 1000 AND int_attr2 = 200 AND str_attr = "str2345" AND str_attr2 = "str9999". Cliquez sur Confirm. Si le résultat JSON renvoyé indique que docsFound et docsReturn sont tous deux égaux à 1, et que les valeurs des champs de l'enregistrement correspondant (int_attr:1000, int_attr2:200, str_attr:"str2345", str_attr2:"str9999") correspondent à la condition de filtre, cela confirme que le filtrage par champ fonctionne correctement.

FAQ

Si je télécharge une seule image sans aucune condition de filtre supplémentaire, comment exclure les résultats provenant d'autres marques (par exemple, une marque de bière différente) ?

Le modèle actuel ne reconnaît pas efficacement le texte présent dans les images ; vous ne pouvez donc pas utiliser directement l'OCR pour distinguer les marques. Pour exclure les marques indésirables des résultats de recherche, essayez l'une des approches suivantes :

  • Ajoutez une condition de filtre fixe dans le code de votre client, telle qu'une catégorie ou un attribut spécifique, afin que seules les images correspondant à cette catégorie ou à cet attribut soient renvoyées.

  • Maintenez la cohérence des valeurs de catégorie ou d'attribut lors de l'ajout d'images à la galerie et lors de la recherche, afin que le filtrage basé sur ces valeurs permette de séparer les marques de manière fiable.

  • Si votre galerie d'images contient plusieurs marques, spécifiez la marque cible comme condition de filtre lors de la recherche, ou combinez un seuil de score de similarité avec votre propre logique de filtrage dans le code pour supprimer les résultats peu pertinents.