Búsqueda web, archivos y voz en la API de DeepSeek: configuración, costes reales y cuándo usar tu propio RAG
Una guía práctica sobre la búsqueda web, la lectura de URL, la entrada de archivos con OCR y la voz en la API de DeepSeek: cómo configurarlas, cuánto cuestan cuando las tarifas por consulta se suman a las tarifas de tokens y un método piloto para decidir qué preguntas van a las herramientas integradas y cuáles se quedan en tu propia pila de recuperación.
Esta guía explica cómo configurar la búsqueda web, la lectura de URL, la entrada de archivos con OCR y la voz en la API de DeepSeek, cuánto cuesta realmente cada respuesta y una forma de decidir a dónde va cada pregunta. Estas funciones también conllevan obligaciones de gobernanza, que se exponen en la primera sección.
Qué ha añadido DeepSeek a la API
La búsqueda funciona sobre el motor de búsqueda propio de DeepSeek. Según el registro de cambios, DeepSeek Search es un motor de búsqueda de propósito general nativo de IA que indexa cientos de miles de millones de páginas web y admite búsquedas multilingües.
Puedes ejecutar la búsqueda con el modo de razonamiento desactivado o activado. Con el razonamiento activado, deepseek_web_search funciona como búsqueda con razonamiento profundo: a lo largo de varios pasos de razonamiento, el modelo busca, abre páginas y localiza texto dentro de ellas, y llega a realizar unas 20 llamadas a herramientas antes de responder. Eso ayuda con preguntas de investigación difíciles. También significa que una sola pregunta de un usuario puede desencadenar mucha actividad facturable, un tema al que vuelven las secciones de costes y advertencias.
El lanzamiento también impone una condición de gobernanza. El anuncio del lanzamiento de DeepSeek indica que las aplicaciones de cara al público deben activar las comprobaciones de seguridad y que los desarrolladores siguen siendo responsables de la moderación de contenidos, del registro de modelos que corresponda y del etiquetado de contenido generado por IA. Así que las aplicaciones públicas deben activar la comprobación de seguridad, pero hacerlo no traslada tu trabajo de cumplimiento normativo a DeepSeek. Considera esto la base de gobernanza para todo lo que sigue.
Si quieres una referencia funcional, DeepSeek publica una demo de chat de código abierto en GitHub. La demo guarda tu clave de API y tu configuración en el localStorage del navegador, y las conversaciones y los archivos adjuntos originales en IndexedDB. Eso sirve para un prototipo local. En producción, mantén las claves en un backend.
Configurar deepseek_web_search y deepseek_read_url en deepseek-flash
Elegir un endpoint
Copia la estructura exacta de la solicitud para el endpoint que uses desde la guía oficial de Web Tools. Trata esa guía como la fuente de referencia cada vez que cambie la API y no adaptes un ejemplo escrito para otro proveedor.
Una secuencia mínima de configuración
- Mantén la clave en un backend. El almacenamiento en el navegador de la demo de chat sirve para un prototipo local y para nada más.
- Empieza con una sola herramienta. Usando la estructura de solicitud de la guía de Web Tools, llama a deepseek-flash con deepseek_web_search activado y el razonamiento desactivado, y luego envía un pequeño conjunto de preguntas reales de usuarios.
- Registra el uso en cada solicitud, con un registro como el que aparece a continuación.
- Añade deepseek_read_url por separado para obtener páginas concretas y pruébalo por sí solo antes de combinar las dos herramientas.
- Activa el razonamiento al final y compara los resultados con tu referencia sin razonamiento.
Qué registrar desde el primer día
El registro siguiente es el formato que sugerimos, no el formato de respuesta de DeepSeek. Los dos valores de tokens proceden del ejemplo de la documentación de DeepSeek; los demás valores son marcadores que rellenas con tu propio tráfico.
{
"route": "public_freshness",
"endpoint": null,
"model": "deepseek-flash",
"thinking": false,
"tools_enabled": ["deepseek_web_search"],
"billed_search_queries": null,
"input_tokens": 9078,
"cached_input_tokens": 4096,
"output_tokens": null,
"latency_ms": null,
"peak_hours": null,
"answer_useful": null
}Vigila sobre todo tres campos: las consultas facturadas, los tokens de entrada y si la respuesta fue útil. El análisis de costes que aparece más adelante en esta guía depende de ellos.
Razonamiento activado o desactivado
La búsqueda con razonamiento profundo ofrece más profundidad, pero menos previsibilidad.
Combinarla con tus propias herramientas de funciones
MxChat informó de que, en sus pruebas, un bot que ya usaba herramientas de funciones, por ejemplo para consultar pedidos o rellenar formularios, no podía añadir la búsqueda web de DeepSeek con el razonamiento desactivado. Te sugerimos confirmarlo en tu propia cuenta antes de darlo por hecho. Si se confirma en tu caso, un asistente que ya llama a tus herramientas solo puede añadir la búsqueda integrada en modo de razonamiento, y asume el perfil de latencia y coste de ese modo.
Lo que no puedes configurar
La herramienta de búsqueda integrada rechaza las opciones allowed_domains, blocked_domains y user_location, así que no puedes limitar los resultados a sitios concretos a través de la herramienta. Si tu requisito dice "cita solo nuestra documentación y estos tres reguladores", la herramienta integrada no puede cumplirlo.
API independientes de búsqueda y obtención
DeepSeek también ofrece la búsqueda y la obtención de páginas como API independientes. Tienen límites por cuenta de 100 consultas por segundo para la búsqueda y 25 para la obtención, distintos de los límites de concurrencia del modelo. Compara esos límites con tu tráfico en hora punta, no con tu media, porque la media te dará una imagen engañosa.
Entrada de archivos y OCR: límites y facturación
La Files API fija límites de tamaño según el tipo de archivo.
| Tipo de archivo | Límite de tamaño |
|---|---|
| Imágenes | 64 MiB |
| Documentos como PDF, Word y PowerPoint | 100 MiB |
| Texto plano, hojas de cálculo y libros electrónicos | 32 MiB |
Según la guía de OCR, el OCR se factura por el número de páginas reconocidas correctamente, y un reconocimiento que falla o excede el tiempo de espera no se factura. Consulta la página de precios para ver las tarifas vigentes antes de elaborar un presupuesto.
La entrada de archivos funciona mejor para preguntas y respuestas puntuales sobre documentos, cuando un usuario sube un contrato o un formulario escaneado y pregunta sobre él. Los equipos que necesitan una base de conocimiento persistente y versionada, con controles de acceso, una estrategia de fragmentación, reglas de actualización y seguimiento de citas, probablemente seguirán teniendo que construir esa capa por su cuenta. Nuestra guía sobre cómo fragmentar tablas de PDF sin perder su origen cubre la parte de procedencia de ese trabajo.
Voz: de voz a texto y de texto a voz
Empieza por la cobertura de idiomas. Según la documentación de DeepSeek, el reconocimiento de voz admite 21 idiomas, entre ellos el ruso, mientras que la síntesis de voz admite 10 idiomas, y el ruso no está entre ellos. En la práctica, un producto podría aceptar una pregunta hablada en un idioma en el que no puede responder en voz alta. La cobertura puede ampliarse, así que sigue el registro de cambios y confirma tus idiomas objetivo en la documentación de voz de DeepSeek antes de comprometerte.
Los costes de voz merecen la misma atención. En la única muestra de MxChat, leer en voz alta una respuesta de 213 caracteres costó unos $0.0096 a precio de lista, mientras que generar esa respuesta en deepseek-flash costó unos $0.0006, de modo que la salida de voz costó unas 16 veces lo que la generación de texto. Una muestra breve no es una previsión, pero sí demuestra que la salida de voz puede costar más que el texto que lee, así que modélala por separado.
Lo que cuesta realmente la búsqueda web de DeepSeek: tarifas de herramientas sobre las tarifas de tokens
La tarifa por búsqueda es solo una línea de la factura.
Tarifas de tokens y horas punta
Las tarifas fuera de hora punta son la mitad de las tarifas en hora punta. Las horas punta van de 01:00 a 04:00 y de 06:00 a 10:00 UTC, de lunes a viernes, excluidos los días festivos oficiales de China.
Comportamiento de facturación que debes tener en cuenta en el diseño
La búsqueda web se factura por consulta, no por llamada. Una llamada de búsqueda que devuelve resultados se factura por cada una de sus consultas, así que una llamada con tres consultas cuenta como tres. Una llamada que falla o no devuelve resultados no se factura. Eso significa que tu presupuesto tiene que basarse en el número de consultas que el modelo realmente emite, y registrar el tráfico real es la única forma de conocer esa cifra. El trazado por solicitud, tal como se describe en nuestro manual de trazado GenAI con OpenTelemetry, te proporciona un registro de llamadas a herramientas y recuentos de tokens sobre el que construir ese presupuesto.
Lo que no cubren los descuentos
Las tarifas de búsqueda no se abaratan fuera de hora punta ni con la caché, porque las horas a mitad de precio y el descuento por caché de DeepSeek se aplican solo a los tokens. La parte de búsqueda de la factura es la misma a cualquier hora.
Crecimiento del contexto
La búsqueda también agranda tu contexto. En el ejemplo de la documentación, una solicitud de búsqueda usó 9,078 tokens de entrada más 4,096 tokens en caché. El contenido de las páginas que recupera el modelo se convierte en entrada, y la entrada se paga.
Lo que encontró la prueba de MxChat
MxChat probó respuestas con y sin búsqueda en deepseek-flash.
| Métrica (prueba de MxChat) | Sin búsqueda | Con búsqueda |
|---|---|---|
| Búsquedas facturadas por respuesta | Ninguna | 2.9 de media |
| Tokens de entrada por respuesta | 4,070 | 13,803 |
| Coste por 1,000 respuestas, fuera de hora punta | $0.63 | $3.64 |
| Tarifas de búsqueda como parte de la factura | No aplica | 60% |
En la prueba de MxChat, las respuestas con búsqueda desencadenaron de media 2.9 búsquedas facturadas, y los tokens de entrada por respuesta pasaron de 4,070 sin búsqueda a 13,803 con ella. Fuera de hora punta, 1,000 respuestas costaron $0.63 sin búsqueda y $3.64 con búsqueda, y las tarifas de búsqueda supusieron el 60% de la factura. Dicho de otro modo, en esta prueba una respuesta con búsqueda costó casi seis veces más que una sin búsqueda, y la mayor parte de esa diferencia procedía de las tarifas por consulta y de los tokens de entrada adicionales, no de la respuesta en sí.
Contexto del mercado
Anthropic fija el precio de lista de su herramienta de búsqueda web de Claude en $10 por 1,000 búsquedas y OpenAI fija el de su herramienta de búsqueda web en $10 por 1,000 llamadas, en ambos casos más el coste de los tokens. Te sugerimos comparar esos precios de lista con la tarifa por consulta vigente de DeepSeek en su página de precios. Ten en cuenta que la tarifa por búsqueda es solo una parte de la comparación. Cuántas consultas desencadena cada respuesta y cuánto añade cada búsqueda al contexto pueden importar igual o más.
El piloto de enrutamiento por tipo de pregunta
La página de precios por sí sola no te dará una decisión. El método siguiente, que llamamos piloto de enrutamiento por tipo de pregunta, es una prueba breve sobre tu propio tráfico. En lugar de un sí o un no para todo el producto, termina con una decisión de enrutamiento para cada tipo de pregunta. Es un método que sugerimos, no un benchmark publicado.
- Toma una muestra de preguntas reales. Extrae un conjunto representativo de tus registros y clasifícalo en tres tipos: preguntas que necesitan contenido web público actualizado, preguntas sobre documentos subidos y preguntas que dependen de conocimiento privado.
- Ejecuta cada pregunta en cuatro configuraciones. Herramientas desactivadas y activadas, cada una con razonamiento activado y desactivado, registradas con el formato de la sección de configuración.
- No toques tu prompt de sistema de producción. En la prueba de MxChat, un prompt de soporte restrictivo suprimió la búsqueda en la mayoría de los casos: el bot solo buscó en 2 de 16 respuestas. En una de esas dos, ejecutó tres búsquedas facturadas, se le facturaron 12,829 tokens de entrada y aun así respondió que no tenía suficiente información en su base de conocimiento.
- Puntúa las respuestas pagadas pero inútiles. Con el razonamiento desactivado, MxChat comprobó que 6 de 20 respuestas con búsqueda, el 30%, se pagaron y no sirvieron de ayuda. Sigue esta tasa con tus propios datos, porque encarece cada respuesta útil sin aparecer como una partida separada.
- Calcula precios en hora punta y fuera de ella. Aplica ambas tarifas de tokens y luego suma las tarifas por consulta de las herramientas, que nunca tienen descuento.
- Resuelve la gobernanza antes del lanzamiento. Designa un responsable para cada obligación de la base de gobernanza descrita al principio de esta guía.
- Decide por tipo de pregunta. Probablemente enviarás algunos tipos a las herramientas integradas y mantendrás el resto en tu propia recuperación.
Lista de comprobación previa al lanzamiento
- [ ] Estructuras de solicitud copiadas de la guía de Web Tools para tu endpoint
- [ ] Modo de razonamiento elegido por ruta, con la latencia medida
- [ ] Compatibilidad con herramientas de funciones probada en tu propia cuenta
- [ ] Presupuesto elaborado por consulta, incluido el crecimiento de tokens de entrada
- [ ] Costes de voz modelados a precio de lista e idiomas de TTS comprobados frente a los mercados objetivo
- [ ] Límites de tasa de las API independientes comprobados frente al tráfico en hora punta
- [ ] Comprobaciones de seguridad activadas y responsables de gobernanza asignados
- [ ] Política de privacidad de DeepSeek revisada por el equipo legal, tras confirmar con DeepSeek que la versión enlazada sigue vigente
Matriz de decisión: herramientas integradas frente a tu propio RAG
Usa esta tabla para interpretar los resultados de tu piloto.
| Dimensión | Herramientas integradas de DeepSeek | Tu propio RAG |
|---|---|---|
| Fuente de datos | Web pública a través del índice de DeepSeek; archivos subidos | Cualquier corpus que controles, incluidos datos privados |
| Control de fuentes | Sin listas de dominios permitidos o bloqueados ni segmentación por ubicación | Control total sobre las fuentes y la clasificación |
| Auditabilidad | Limitada a lo que devuelven el modelo y la herramienta | Tú defines el registro, el versionado y la trazabilidad de citas |
| Residencia de datos | Revisa el tratamiento de datos del proveedor frente a tus reglas de residencia antes del lanzamiento | Puede diseñarse en torno a tus reglas de residencia |
| Previsibilidad de costes | Varía según las consultas por respuesta y el crecimiento del contexto | Infraestructura mayormente fija más tokens |
| Esfuerzo operativo | Bajo; sin rastreador, índice ni OCR que gestionar | Mayor; tú construyes y mantienes el pipeline |
| Rendimiento | Límites de búsqueda y obtención por cuenta en las API independientes (ver la sección de configuración) | Escala con la infraestructura que aprovisiones |
| Páginas con mucho JavaScript | Pruébalo en tus propias páginas objetivo antes de depender de ello | Depende de tu sistema de obtención y renderizado |
Dónde suelen ganar las herramientas integradas
Las herramientas integradas tienen sentido para respuestas con contenido web público actualizado y para búsquedas multilingües sobre un gran índice público. También encajan en funciones de bajo volumen o exploratorias, en preguntas y respuestas puntuales sobre archivos y en equipos que aún no tienen infraestructura de recuperación.
Dónde suele ganar tu propio RAG
Tu propia pila es la mejor opción para corpus privados o internos que un motor público no puede ver. También gana cuando necesitas listas de dominios permitidos o bloqueados, un control estricto de las fuentes con trazabilidad de auditoría, o cuando las reglas de residencia y los contratos restringen a dónde pueden ir los datos. Como la herramienta integrada rechaza los filtros de dominio y ubicación, no puedes garantizar qué fuentes fundamentan una respuesta.
Enfoque híbrido
Para muchos productos la respuesta realista es usar ambos, y el piloto te dice dónde separarlos. Mantén tu propia recuperación para el conocimiento privado y expón la búsqueda integrada solo a los tipos de pregunta que necesitan información pública actualizada.
Advertencias y preguntas abiertas
Las cifras de coste por respuesta de esta guía proceden de la prueba de MxChat, así que tómalas como un dato puntual y no como una previsión.
Los precios, las promociones y los límites pueden cambiar, así que consulta la página de precios y el registro de cambios antes de comprometerte.
La búsqueda con razonamiento profundo se ramifica en muchas llamadas a herramientas, por lo que la latencia y el coste por respuesta variarán mucho. Establece tiempos de espera y límites de presupuesto por solicitud, ya sea en tu propio código o en una capa de enrutamiento como la de nuestro manual de Vercel AI Gateway.
Confirma que la versión enlazada está vigente y luego contrástala con tus contratos y requisitos regulatorios. Nuestra lista de comprobación de riesgos de proveedores de inferencia recoge más preguntas que conviene plantear a cualquier proveedor de modelos.
Puntos clave
- Las herramientas de búsqueda de DeepSeek funcionan sobre su motor de búsqueda propio, que indexa cientos de miles de millones de páginas web.
- La búsqueda web de la API de DeepSeek se factura por consulta, no por llamada, y los descuentos fuera de hora punta y por caché se aplican solo a los tokens, nunca a las tarifas de búsqueda.
- En la prueba independiente de MxChat, las respuestas con búsqueda costaron $3.64 por 1,000 fuera de hora punta frente a $0.63 sin búsqueda, y las tarifas de búsqueda supusieron el 60% de la factura.
- La herramienta de búsqueda integrada rechaza los filtros de dominio y ubicación, y MxChat comprobó que añadir la búsqueda web junto a tus propias herramientas de funciones solo funcionaba en modo de razonamiento.
- En la única muestra de MxChat, el texto a voz costó unas 16 veces lo que la generación de texto; la síntesis de voz cubre 10 idiomas frente a 21 del reconocimiento de voz.
- Las aplicaciones de cara al público deben activar las comprobaciones de seguridad, pero la moderación, el registro y el etiquetado de contenido de IA siguen siendo tarea del desarrollador.
- Ejecuta un piloto de enrutamiento por tipo de pregunta: las herramientas integradas encajan con la web pública actualizada y los archivos puntuales, mientras que los corpus privados, el control de fuentes, la auditabilidad y la residencia apuntan a tu propio RAG.
Conclusión
Las herramientas integradas de DeepSeek te permiten añadir búsqueda web en vivo, lectura de archivos y voz a un producto basado en LLM sin gestionar tu propio rastreador, índice ni pipeline de OCR. Sin embargo, la tarifa por búsqueda es solo una parte de la factura. Lo que pagas realmente depende de cuántas consultas desencadena cada respuesta, cuánto crece el contexto, cuántas búsquedas no sirven de ayuda y cuánto cuesta la salida de voz, y las primeras pruebas independientes sugieren que las tarifas de búsqueda pueden ser la mayor parte. Prueba algunas restricciones en lugar de darlas por supuestas: no hay filtros de dominio ni de ubicación, según los informes combinar la búsqueda con tus propias herramientas de funciones requiere el modo de razonamiento, y las obligaciones de gobernanza siguen siendo tuyas.
Así que ejecuta el piloto de enrutamiento por tipo de pregunta sobre tu propio tráfico con tu prompt de sistema real, calcula los precios con las tarifas en hora punta y fuera de ella, y envía cada tipo de pregunta a la opción que mejor le sirva. Para la mayoría de los equipos, el resultado acaba siendo un enfoque híbrido, con la búsqueda integrada encargándose de la información pública actualizada y tu propia recuperación encargándose de todo lo privado, controlado o auditado. Si te vendría bien una segunda opinión sobre el diseño de tu piloto o tu modelo de costes, el equipo de Optijara estará encantado de comentarlo contigo.
Preguntas frecuentes
¿Cuánto cuesta la búsqueda web integrada de DeepSeek en comparación con OpenAI y Anthropic?
Anthropic fija el precio de lista de su herramienta de búsqueda web de Claude en $10 por 1,000 búsquedas y OpenAI fija el de su herramienta de búsqueda web en $10 por 1,000 llamadas, en ambos casos más el coste de los tokens. Consulta la página de precios de DeepSeek para ver su tarifa vigente por consulta de búsqueda. DeepSeek factura por consulta, así que una llamada con tres consultas cuenta como tres, y las búsquedas fallidas o vacías no se facturan. El coste real por respuesta útil depende de cuántas consultas emite el modelo y de cuánto contenido de búsqueda añade a los tokens de entrada.
¿Se aplican los descuentos fuera de hora punta de DeepSeek a las tarifas de búsqueda web y de obtención?
No. Las tarifas de tokens fuera de hora punta son la mitad que en hora punta, con horas punta de 01:00 a 04:00 y de 06:00 a 10:00 UTC en días laborables, excluidos los días festivos oficiales de China. Las horas a mitad de precio y el descuento por caché de DeepSeek se aplican solo a los tokens, así que las tarifas de búsqueda son las mismas a cualquier hora del día.
¿Puedo limitar la búsqueda web de DeepSeek a dominios concretos o a un país?
No a través de la herramienta integrada. Rechaza las opciones allowed_domains, blocked_domains y user_location, así que no puedes limitar los resultados a sitios concretos. Si necesitas listas de fuentes permitidas o bloqueadas o segmentación por ubicación, mantén esa recuperación en tu propio pipeline.
¿Puedo usar la búsqueda web de DeepSeek junto con mis propias herramientas de funciones?
Es posible, pero pruébalo primero. En las pruebas de MxChat, un bot que ya usaba herramientas de funciones, por ejemplo para consultar pedidos o rellenar formularios, no podía añadir la búsqueda web de DeepSeek con el razonamiento desactivado, de modo que la combinación solo funcionó en modo de razonamiento. Te sugerimos confirmarlo en tu propia cuenta. En modo de razonamiento, la búsqueda con razonamiento profundo puede realizar unas 20 llamadas a herramientas antes de responder, así que cuenta con que la latencia y el coste varíen más.
¿Qué tamaños de archivo acepta la Files API de DeepSeek y cómo se factura el OCR?
Las imágenes pueden ocupar hasta 64 MiB; los documentos como PDF, Word y PowerPoint, hasta 100 MiB; y el texto plano, las hojas de cálculo y los libros electrónicos, hasta 32 MiB. El OCR se factura por el número de páginas reconocidas correctamente; los reconocimientos fallidos o que exceden el tiempo de espera no se facturan. Consulta la página de precios para ver las tarifas vigentes antes de presupuestar.
¿Debería sustituir mi pipeline de RAG por las herramientas integradas de DeepSeek?
Normalmente no del todo. Las herramientas integradas encajan con preguntas sobre la web pública actualizada, búsquedas multilingües y preguntas y respuestas puntuales sobre archivos. Tu propio RAG sigue siendo la mejor opción para corpus privados, control de dominios, trazabilidad de auditoría y requisitos de residencia. Ejecuta un piloto de enrutamiento por tipo de pregunta con preguntas reales y sin modificar tu prompt de producción. En la prueba de MxChat, un prompt restrictivo suprimió la búsqueda en la mayoría de los casos, y con el razonamiento desactivado el 30% de las respuestas con búsqueda se facturaron pero no sirvieron de ayuda. Enruta por tipo de pregunta en lugar de cambiar todo el producto.
Fuentes
- https://api-docs.deepseek.com/news/news261113/
- https://api-docs.deepseek.com/quick_start/pricing/
- https://api-docs.deepseek.com/guides/web_tools/
- https://api-docs.deepseek.com/guides/build_a_chatbot/
- https://api-docs.deepseek.com/guides/files_api/
- https://api-docs.deepseek.com/guides/ocr/
- https://api-docs.deepseek.com/updates/
- https://github.com/deepseek-ai/chat-demo
- https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy-2025-02-14.html
- https://mxchat.ai/deepseek-web-search-api-pricing-chatbot-test/
- https://www.datastudios.org/post/deepseek-api-web-search-ocr-voice-0-75-per-1000-searches
- https://tproger.ru/news/deepseek-otkryla-v-api-poisk-chtenie-fajlov-i-golos-iz-svoego-pr



