phaseo:web_search para que el modelo pueda buscar en la web cuando necesite información actual o respaldada por fuentes. El modelo redacta la consulta y puede buscar varias veces en una misma solicitud; Phaseo devuelve URL, títulos, fragmentos, destacados y, opcionalmente, el texto de las páginas, y el modelo redacta una respuesta fundamentada.
tools en /v1/responses y /v1/messages.
Parámetros
Qué envía el modelo
Cada llamada incluye unaquery. El modelo también puede enviar max_results, engine, search_context_size, las listas de dominios, include_text, include_highlights, max_characters y estas indicaciones de localización:
Los valores que envía el modelo sustituyen los predeterminados de la herramienta en esa llamada.
max_results sigue limitado por lo que quede de max_total_results; cuando se agota, las llamadas siguientes devuelven max_total_results_reached.
Elegir un motor
Si un motor gestionado no está habilitado, la llamada devuelve
search_not_configured al modelo.
Con engine: "native" en /v1/chat/completions o /v1/responses, la solicitud solo va a proveedores que ejecutan la búsqueda web por sí mismos. Si ninguno ofrece el modelo, Phaseo ejecuta en su lugar su motor predeterminado y lo factura como búsqueda gestionada.
Los proveedores que ejecutan la búsqueda web por sí mismos en estos endpoints son OpenAI, los despliegues de Azure OpenAI en /v1/responses, xAI y DeepSeek en deepseek/deepseek-v4.1-flash-1017. DeepSeek busca por su cuenta solo cuando la búsqueda web es la única herramienta de la solicitud, sin listas de dominios ni ubicación del usuario, sin salida JSON y sin un tool_choice forzado. Su API rechaza las listas de dominios, la ubicación y la salida JSON, desactiva su búsqueda web cuando la solicitud tiene otras herramientas y no puede forzar una búsqueda. Las demás solicitudes a ese modelo usan en su lugar la búsqueda de Phaseo, que funciona junto con tus propias herramientas. Con el razonamiento activado, DeepSeek ejecuta una búsqueda más profunda que abre y lee páginas en varios pasos.
Enviar la herramienta propia de OpenAI { "type": "web_search" } funciona igual que engine: "native". Define native solo en la definición de la herramienta: si el modelo pide native en una llamada, la llamada devuelve unsupported_search_engine, porque la herramienta del proveedor debe elegirse antes de enviar la solicitud.
Filtrar por dominio
Usaallowed_domains cuando la respuesta deba proceder de un conjunto fijo de fuentes, y excluded_domains para quitar sitios concretos de una búsqueda por lo demás abierta.
- Perplexity acepta una de las dos listas, no ambas, con hasta 20 dominios. Los dominios excluidos se envían en su formato de lista de bloqueo.
- Firecrawl acepta una de las dos listas, no ambas.
- TinyFish acepta ambas y las convierte en operadores
site:y-site:en la consulta. - DeepSeek acepta ambas y las convierte en operadores
site:y-site:. Sus consultas están limitadas a 128 caracteres, así que la consulta se acorta para dejar espacio a los operadores. Si solo las listas de dominios ya superan el límite, la llamada devuelvesearch_query_too_long.
Qué devuelve la herramienta
Un resultado JSON con el motor, la consulta y una matrizresults. Cada resultado tiene title, url, snippet o highlights, y text cuando se pidió el texto de la página y el motor lo proporciona.
Uso y precios
Cada búsqueda suma ausage.server_tool_use:
server_tool_web_search_requests y server_tool_web_search_extra_results. Las búsquedas fallidas no se cobran, y TinyFish Search es gratuito en sus planes publicados, así que engine: "tinyfish" no añade cargo de búsqueda. Las búsquedas con motores de pago requieren saldo aunque el modelo sea gratuito. La búsqueda nativa se cobra con native_web_search_requests al precio publicado del proveedor: por ejemplo, $10 por 1,000 búsquedas en OpenAI y Anthropic, y $0.75 por 1,000 en DeepSeek, donde solo cuentan las búsquedas que devuelven resultados. DeepSeek también cobra cada lectura de página, en la que lee una URL con su herramienta de lectura de enlaces, a $0.75 por 1,000, como native_web_fetch_requests. Con el razonamiento activado, una sola respuesta de DeepSeek puede ejecutar una docena de búsquedas o más, y los resultados que lee se suman a los tokens de entrada.