A ferramenta de busca por imagem permite que o modelo pesquise na internet imagens visualmente semelhantes com base em uma imagem de entrada. O modelo analisa os resultados da pesquisa e faz inferências. Esse recurso é útil para cenários como encontrar produtos similares ou rastrear a origem de conteúdo visual.
Como usar
Chame o recurso de busca por imagem pela Responses API. Adicione a ferramenta image_search ao parâmetro tools e passe a imagem no parâmetro input em formato multimodal.
O parâmetroinputdeve conter conteúdo de imagem. Passe a URL da imagem usando o tipoinput_image. Você também pode passar texto usando o tipoinput_textpara fornecer informações adicionais à pesquisa.
Modelos suportados
Modelos recomendados
Para obter o melhor desempenho na chamada de ferramentas, use os seguintes modelos:
Qwen-Plus: série Qwen3.7-Plus, série Qwen3.6-Plus, série Qwen3.5-Plus
Qwen-Max: série Qwen3.8-Max, qwen3.7-max-2026-06-08
qwen3.8-27b
Outros modelos
Os modelos abaixo também oferecem suporte a esta ferramenta, mas apresentam desempenho inferior aos modelos recomendados.
- Qwen-Flash: série Qwen3.7-Flash, série Qwen3.6-Flash, série Qwen3.5-Flash
Primeiros passos
Execute o código a seguir para chamar a ferramenta de busca por imagem pela Responses API e pesquisar imagens semelhantes ou relacionadas com base na imagem de entrada.
Antes de começar, obtenha uma chave de API e configure a chave de API como uma variável de ambiente .
Substitua o valor de image_url no código de exemplo por uma URL de imagem publicamente acessível.
Saída em streaming
A ferramenta de busca por imagem tem um tempo de processamento longo. Ative a saída em streaming para recuperar resultados intermediários em tempo real.
Faturamento
O faturamento envolve os seguintes aspectos:
- Taxas de chamada do modelo: Os resultados da busca por imagem são anexados ao prompt, o que aumenta o número de tokens de entrada do modelo. A cobrança segue a tarifa padrão do modelo. Para detalhes de preços, consulte o console do Model Studio.
- Taxas de chamada de ferramenta: A cobrança é feita a cada 1.000 chamadas. A taxa é de $8,00 para implantações na região de Singapore, enquanto a taxa para implantações em North China 2 (Beijing) é de $6.881.
Perguntas frequentes
P: Quais formatos de imagem e métodos de entrada são suportados?
R: Para mais informações, consulte Image limits e File input methods.
O SDK da OpenAI não oferece suporte à passagem de caminhos de arquivos locais.
P: Quantas imagens podem ser enviadas?
R: A quantidade de imagens permitida depende do comprimento máximo de entrada do modelo. O total de tokens das imagens e do texto não deve exceder o valor máximo suportado pelo modelo. O modelo pesquisa apenas uma imagem por chamada, mas você pode fazer múltiplas chamadas para processar várias imagens.
O modelo decide quantas imagens pesquisar.