La herramienta de búsqueda por imagen permite al modelo buscar en Internet imágenes visualmente similares basándose en una imagen de entrada. Luego, el modelo puede analizar los resultados de la búsqueda y realizar inferencias. Esta función es útil para escenarios como encontrar productos similares o rastrear el origen de contenido visual.
Cómo usar
Puede llamar a la función de búsqueda por imagen a través de la API de Responses. Agregue la herramienta image_search al parámetro tools y pase la imagen en el parámetro input en formato multimodal.
El parámetroinputdebe contener contenido de imagen. Pase la URL de la imagen utilizando el tipoinput_image. También puede pasar texto utilizando el tipoinput_textpara proporcionar información adicional para la búsqueda.
Modelos admitidos
Modelos recomendados
Para un rendimiento óptimo de llamadas a herramientas, utilice los siguientes modelos:
Qwen-Plus: serie Qwen3.7-Plus, serie Qwen3.6-Plus, serie Qwen3.5-Plus
Qwen-Max: qwen4-max-preview (solo Token Plan), serie Qwen3.8-Max, qwen3.7-max-2026-06-08
qwen3.8-27b
Otros modelos
Los siguientes modelos también admiten esta herramienta, pero su rendimiento no es tan alto como el de los modelos recomendados.
- Qwen-Flash: serie Qwen3.7-Flash, serie Qwen3.6-Flash, serie Qwen3.5-Flash
Introducción
Puede ejecutar el siguiente código para llamar a la herramienta de búsqueda por imagen a través de la API de Responses y buscar imágenes similares o relacionadas basándose en la imagen de entrada.
Antes de comenzar, obtenga una clave de API y configure la clave de API como variable de entorno.
Reemplace image_url en el código de ejemplo con una URL de imagen accesible públicamente.
Salida por secuencias
La herramienta de búsqueda por imagen tiene un tiempo de procesamiento prolongado. Puede habilitar la salida en streaming para recuperar resultados intermedios en tiempo real.
Facturación
La facturación implica los siguientes aspectos:
- Tarifas de llamada al modelo: Los resultados de la búsqueda de imágenes se añaden al prompt. Esto aumenta el número de tokens de entrada para el modelo. Se le cobra según la tarifa estándar del modelo. Para obtener detalles sobre los precios, consulte la consola de Model Studio.
- Tarifas de llamada a herramientas: Se le cobra por cada 1,000 llamadas. La tarifa es de $8.00 para implementaciones en la región de Singapore, mientras que la tarifa para implementaciones en Norte de China 2 (Beijing) es de $6.881.
FAQ
P: ¿Qué formatos de imagen y métodos de entrada se admiten?
R: Para obtener más información, consulte Límites de imagen y Métodos de entrada de archivos.
El SDK de OpenAI no admite pasar rutas de archivos locales.
P: ¿Cuántas imágenes se pueden pasar?
R: El número de imágenes que puede pasar está limitado por la longitud máxima de entrada del modelo. El número total de tokens tanto para las imágenes como para el texto no debe exceder el valor máximo que admite el modelo. El modelo busca solo una imagen por llamada, pero puede realizar múltiples llamadas para procesar varias imágenes.
El modelo decide el número de imágenes a buscar.