L'outil de recherche par image permet au modèle de rechercher sur Internet des images visuellement similaires à partir d'une image fournie en entrée. Le modèle peut ensuite analyser les résultats et en tirer des déductions. Cette fonctionnalité s'avère utile pour rechercher des produits similaires ou identifier l'origine d'un contenu visuel.
Utilisation
Appelez la fonctionnalité de recherche par image via l'API Responses. Ajoutez l'outil image_search au paramètre tools et transmettez l'image dans le paramètre input au format multimodal.
Le paramètreinputdoit contenir le contenu de l'image. Transmettez l'URL de l'image avec le typeinput_image. Vous pouvez également transmettre du texte avec le typeinput_textpour fournir des informations supplémentaires pour la recherche.
Modèles pris en charge
Modèles recommandés
Pour des performances optimales lors de l'appel d'outils, utilisez les modèles suivants :
Qwen-Plus : séries Qwen3,7-Plus, Qwen3,6-Plus, Qwen3,5-Plus
Qwen-Max : qwen4-max , série Qwen3,8-Max, qwen3,7-max-2026-06-08
qwen3,8-27b
Autres modèles
Les modèles suivants prennent également en charge cet outil, mais leurs performances sont inférieures à celles des modèles recommandés.
- Qwen-Flash : séries Qwen3,7-Flash, Qwen3,6-Flash, Qwen3,5-Flash
Premiers pas
Exécutez le code suivant pour appeler l'outil de recherche par image via l'API Responses et rechercher des images similaires ou connexes à partir de l'image fournie en entrée.
Avant de commencer, obtenez une clé API et configurez la clé API en tant que variable d'environnement .
Remplacez la valeur image_url dans l'exemple de code par une URL d'image accessible publiquement.
python
Sortie en streaming
Le traitement de l'outil de recherche par image prend du temps. Activez la sortie en streaming pour récupérer les résultats intermédiaires en temps réel.
python
Facturation
La facturation comprend les aspects suivants :
- Frais d'appel de modèle : les résultats de la recherche d'images sont ajoutés à l'invite. Cela augmente le nombre de jetons d'entrée pour le modèle. La facturation s'effectue selon le tarif standard du modèle. Pour plus de détails sur les tarifs, consultez la console Model Studio.
- Frais d'appel d'outil : la facturation s'effectue par tranche de 1 000 appels. Le tarif est de 8,00 USD pour les déploiements dans la région de Singapour, tandis que le tarif pour les déploiements dans la région Chine du Nord 2 (Pékin) est de 6 881 USD.
FAQ
Q : Quels formats d'image et méthodes d'entrée sont pris en charge ?
R : Pour plus d'informations, consultez les sections Limites des images et Méthodes d'entrée de fichier.
Le SDK OpenAI ne prend pas en charge la transmission de chemins de fichiers locaux.
Q : Combien d'images puis-je transmettre ?
R : Le nombre d'images que vous pouvez transmettre est limité par la longueur d'entrée maximale du modèle. Le nombre total de jetons pour les images et le texte ne doit pas dépasser la valeur maximale prise en charge par le modèle. Le modèle ne recherche qu'une seule image par appel, mais vous pouvez effectuer plusieurs appels pour traiter plusieurs images.
Le modèle décide du nombre d'images à rechercher.