Image Search:Requête d'image

Informations générales

Image Search vous permet d'interroger des images via l'API, le SDK (recommandé) ou la console (pour explorer les fonctionnalités).

Méthode via la console

1. Connectez-vous à la console Image Search.

2. Sélectionnez le type de service et l'instance cibles.

3. Cliquez sur Image Search. Dans l'onglet Image Search, configurez les paramètres de recherche sur la gauche, puis cliquez sur Confirm pour lancer la recherche. Les résultats de la recherche s'affichent au format JSON dans la section Response parameters à droite. Les résultats incluent des champs tels que score (score de similarité), productId et picName.

   Paramètre	Paramètre API	Description	Obligatoire
   Type de recherche	Type	Le type de recherche. Valeurs possibles : SearchByPic : Recherche des images similaires à une image fournie. Il s'agit de l'option par défaut. SearchByName : Recherche des images similaires à l'aide d'une image précédemment indexée.	Oui
   Télécharger l'image	PicContent	Le contenu de l'image, encodé en Base64. L'image doit répondre aux exigences suivantes : La taille de l'image ne peut pas dépasser 4 Mo. Formats pris en charge : PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF et PPM. La latence de transfert ne peut pas dépasser 5 secondes. Pour la recherche d'images de produits et la recherche d'images génériques, la hauteur et la largeur de l'image doivent être comprises entre 100 et 4 096 pixels, inclus. L'image ne doit pas contenir d'informations de rotation.	Oui
   Identification du sujet	Crop	Indique s'il faut effectuer une identification du sujet sur l'image téléchargée. true : active l'identification du sujet, y compris l'identification automatique par le système et l'identification personnalisée du sujet. Pour plus d'informations, consultez la description du paramètre Méthode d'identification du sujet. false : désactive l'identification du sujet. La recherche utilise l'intégralité de l'image.	Oui
   Méthode d'identification du sujet	Non applicable	Spécifie la méthode d'identification du sujet. Identification automatique par le système : le système identifie automatiquement le sujet et utilise le sujet identifié pour la recherche. La réponse inclut le résultat de l'identification du sujet. Région de sujet personnalisée : vous pouvez personnaliser la région du sujet. Le format est x1,x2,y1,y2, où x1,y1 représente le coin supérieur gauche et x2,y2 représente le coin inférieur droit. Cliquez sur cette option et faites glisser pour sélectionner la région du sujet. Si vous ne spécifiez pas de région de sujet personnalisée, la recherche utilise l'intégralité de l'image.	Oui
   Catégorie d'image	CategoryId	La catégorie d'image. Vous pouvez spécifier la catégorie d'une image lors d'une recherche d'image. Pour plus d'informations, consultez Référence des catégories. Remarque Pour la recherche de produits, si vous spécifiez une catégorie, le service l'utilise. Si vous ne spécifiez pas de catégorie, le système effectue une prédiction de catégorie. La réponse inclut la catégorie prédite. Pour la recherche de la recherche générique, le service définit la catégorie sur 88888888, que vous spécifiiez ou non une catégorie.	Non
   Nombre de résultats	Num	Le nombre maximal de résultats similaires à renvoyer. Valeurs possibles : 1 à 100. Valeur par défaut : 10.	Non
   Position de départ	Start	La position de départ des résultats similaires renvoyés. Valeurs possibles : 0 à 499. Valeur par défaut : 0.	Oui
   Condition de filtrage	Filter	Vous pouvez spécifier des conditions pour filtrer les résultats de recherche. Par exemple, vous pouvez renvoyer uniquement les résultats d'image où ownerId est 1000 ou le nom de l'entreprise est « alibaba ». Remarque int_attr prend en charge les opérateurs >, >=, <, <=, =, in et not in. str_attr prend en charge les opérateurs =, !=, in et not in. Vous pouvez utiliser AND et OR pour connecter plusieurs conditions. Exemple : int_attr=1000 AND str_attr="value1".	Non
   Filtre de score de similarité	ScoreThreshold	Si vous spécifiez un seuil de score de similarité, le service renvoie uniquement les images dont le score est supérieur ou égal au seuil. Le seuil peut être une valeur comprise entre 0,00 et 1,00, avec jusqu'à deux décimales. La valeur par défaut est 0,00.	Non

4. Consultez les résultats.

   Le tableau suivant décrit les paramètres de réponse.

   Paramètre	Type	Exemple	Description
   Success	Boolean	true	Indique si la requête a réussi.
   RequestId	String	36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1	L'ID de la requête.
   Code	Integer	0	Le code d'erreur. 0 : la requête a réussi. Une valeur non nulle indique un échec de la requête.
   Message	String	success	Le message d'erreur.
   Head	-	-	Contient des informations sur le résultat de la recherche.
   └DocsReturn	Integer	10	Le nombre de résultats renvoyés.
   └DocsFound	Integer	10000	Le nombre de résultats correspondants dans l'instance.
   └SearchTime	Integer	95	La durée de la recherche, en millisecondes.
   PicInfo	-	-	Informations sur la prédiction de catégorie et les résultats d'identification du sujet.
   └CategoryId	Integer	88888888	Le résultat de la prédiction de catégorie. Si vous avez spécifié une catégorie dans la requête, ce paramètre renvoie cette catégorie.
   └Region	String	280,486,232,351	Le résultat de l'identification du sujet. Il s'agit de la région du sujet de l'image, au format x1,x2,y1,y2. x1 et y1 représentent le coin supérieur gauche, et x2 et y2 représentent le coin inférieur droit. Si vous avez spécifié une région de sujet dans la requête, ce paramètre renvoie cette région.
   └AllCategories	-	-	Une liste de toutes les catégories prises en charge.
   └└Name	String	Tops	Le nom de la catégorie.
   └└Id	Integer	0	L'ID de la catégorie.
   └MultiRegion	-	-	Une collection de résultats d'identification du sujet. Remarque Ce paramètre est disponible uniquement dans la version V3.1.1 et ultérieures.
   └└Region	String	280,486,232,351	Le résultat de l'identification du sujet. Il s'agit de la région du sujet de l'image, au format x1,x2,y1,y2. x1 et y1 représentent le coin supérieur gauche, et x2 et y2 représentent le coin inférieur droit. Si vous avez spécifié une région de sujet dans la requête, ce paramètre renvoie cette région.
   Auctions	-	-	Les descriptions de tous les produits renvoyés.
   └CustomContent	String	Demo Custom Content	Le contenu personnalisé.
   └PicName	String	DemoPic	Le nom de l'image.
   └CategoryId	Integer	0	La catégorie de l'image.
   └ProductId	String	test	L'ID du produit.
   └SortExprValues	String	7.33136443711219e+24;0	Les informations de notation du système. Remarque Ce champ est obsolète. Nous vous recommandons d'utiliser Score à la place.
   └Score	Float	1	Le score de similarité de l'image. Plage de valeurs : 0 à 1. Remarque Ce paramètre est disponible uniquement dans la version V3.1.1 et ultérieures.
   └IntAttr	Integer	0	Un attribut entier du produit.
   └IntAttr2	Integer	0	Un attribut entier du produit.
   └IntAttr3	Integer	0	Un attribut entier du produit.
   └IntAttr4	Integer	0	Un attribut entier du produit.
   └StrAttr	String	demoStrAttr	Un attribut de chaîne du produit.
   └StrAttr2	String	demoStrAttr	Un attribut de chaîne du produit.
   └StrAttr3	String	demoStrAttr	Un attribut de chaîne du produit.
   └StrAttr4	String	demoStrAttr	Un attribut de chaîne du produit.

Méthode API

L'accès direct via les protocoles HTTP ou HTTPS nécessite une authentification à l'aide d'un mécanisme de signature, et le corps de la requête doit être transmis dans un format spécifique. Le QPS pour l'interrogation d'images similaires via l'API est déterminé par le plan QPS acheté. Pour plus de détails, consultez Rechercher des images par nom ou Rechercher des images par image.

Méthode SDK

Image Search propose diverses versions du SDK, éliminant ainsi la nécessité de gérer des paramètres complexes tels que la vérification de signature et l'assemblage du corps de la requête. Le QPS pour l'interrogation d'images similaires via le SDK est déterminé par le plan QPS acheté. Pour plus de détails, consultez Référence du SDK.