Poner model en deepseek-flash no enciende la búsqueda. El 13 de noviembre de 2026 DeepSeek abrió en la API las herramientas que hay detrás de su app de chat. El id deepseek-flash es DeepSeek-V4.1-Flash-1017. Los ids antiguos deepseek-v4-flash y deepseek-v4-flash-vision-exp siguen llegando aquí y se cobran al precio Flash. El contexto es de 1.000.000 de tokens. La salida máxima es de 384.000. Pensar es el valor por defecto.
Esta página está fechada el 16 de noviembre de 2026 a partir del registro del 13 de noviembre, la guía de herramientas web, la guía de Search y Fetch, la guía de seguridad y la página de precios. Hace tres días cubrimos el usage de Gemini 4 Carbon. Aquí los campos que cambian la petición y la factura son tools, thinking, safety_check y usage.server_tool_use.
Qué se abrió el 13 de noviembre
El mismo modelo acepta las herramientas en tres puntos. Messages es POST https://api.deepseek.com/anthropic/v1/messages con x-api-key. Responses es POST https://api.deepseek.com/responses. Chat Completions es POST https://api.deepseek.com/chat/completions. Los dos últimos envían Authorization: Bearer. Search, Fetch, OCR, ASR y TTS también existen como llamadas sueltas. La búsqueda de imágenes no está en POST /v1/tools/search. Solo corre dentro de deepseek_web_search.
| Capacidad | JSON que la enciende | Qué vuelve |
|---|---|---|
| Búsqueda web | deepseek_web_search, pensar apagado | El modelo busca cuando lo decide y cita |
| Búsqueda con razonamiento | deepseek_web_search, pensar encendido | search, open_page, find_in_page, unas 20 llamadas |
| Lectura de URL | deepseek_read_url | Enlaces del último mensaje de usuario, como máximo las 10 primeras URL distintas |
| Seguridad | safety_check.level = high | Revisa entrada y salida. DeepSeek lo pide en un servicio público |
| Archivos | file_id de la API Files | PDF, Office e imágenes se analizan antes del turno |
JSON de la petición en tres puntos
Messages nombra cada herramienta dos veces, type y name. Responses y Chat envían solo type. tool_choice no puede nombrar estas herramientas. Eso devuelve 400, deepseek_web_search cannot be forced. tool_choice none apaga toda herramienta web declarada, incluida la lectura de URL. En Responses y Chat, required se trata como auto.
No envíes allowed_domains, blocked_domains ni user_location. No declares la misma herramienta dos veces. No mezcles otra herramienta de servidor. El error dice que otras herramientas aún no pueden usarse junto con deepseek_web_search, deepseek_read_url, safety_check o title. En Responses, una herramienta web_search y un text.format distinto de text devuelven 400. En Chat, web_search_options y un response_format distinto de text devuelven 400. El JSON estructurado y estas herramientas web no comparten una petición. Deja tu esquema para una llamada posterior. Véase qué es la salida estructurada.
Pensar apagado es la búsqueda con citas. Pensar encendido es la búsqueda profunda. Si ambos están activos, la ronda no ejecuta deepseek_read_url. Los enlaces se leen cuando pensar está apagado, o cuando solo se declara deepseek_read_url. Messages y Chat ponen thinking.type en disabled o enabled. El ejemplo de Responses para la búsqueda profunda pone reasoning.effort en high.
{
"model": "deepseek-flash",
"thinking": {
"type": "disabled"
},
"safety_check": {
"level": "high"
},
"tools": [
{
"type": "deepseek_web_search",
"name": "deepseek_web_search"
},
{
"type": "deepseek_read_url",
"name": "deepseek_read_url"
}
],
"messages": [
{
"role": "user",
"content": "What changed in the DeepSeek API on 13 November 2026?"
}
]
}Responses, con búsqueda y razonamiento:
{
"model": "deepseek-flash",
"reasoning": {
"effort": "high"
},
"safety_check": {
"level": "high"
},
"tools": [
{
"type": "deepseek_web_search"
},
{
"type": "deepseek_read_url"
}
],
"input": "Which official page states the height of Tokyo Tower?"
}Bloques, kind y citas
En Messages, cada llamada es un bloque server_tool_use más un resultado. Empáralos con tool_use_id. En un flujo, ambos bloques llegan enteros en content_block_start. Lee el usage final en message_delta. El usage de message_start solo cubre el primer paso de inferencia.
| input.action | name | kind | Resultado |
|---|---|---|---|
search | deepseek_web_search | deep_search al pensar, si no search | web_search_tool_result |
open_page | deepseek_web_search | deep_search | web_fetch_tool_result. data es una cadena vacía. No hay signature |
find_in_page | deepseek_web_search | deep_search | La misma forma. title es null. No se cobra |
read_link | deepseek_read_url | read_link | web_fetch_tool_result más signature |
La búsqueda de imágenes pone kind en image_search o deep_image_search. queries es un array vacío. Un resultado puede añadir image_url solo para mostrarlo. Las citas de Messages van en bloques text como web_search_result_location. cited_text es el texto de respuesta de ese bloque, no una cita de la página. encrypted_index es siempre una cadena vacía. Una URL como máximo por bloque. En un flujo llegan como citations_delta.
Responses pone la llamada en un web_search_call con kind y action. La respuesta es output_text con anotaciones url_citation. start_index y end_index cuentan puntos de código Unicode. Chat pone las llamadas en message.server_tool_calls. Cada paso tiene reasoning_content y calls. message.content no tiene marcas de cita. Las citas están en message.annotations. message.reasoning_content es solo el último paso.
Una respuesta que usó estas herramientas no se puede continuar. La API devuelve 400 y pide reenviar la petición anterior. En el turno siguiente, devuelve el contenido del asistente sin cambios, incluidos kind y signature. Los fragmentos de búsqueda y el razonamiento anterior no vuelven al contexto. Solo el texto de la respuesta. Una página leída vuelve desde signature. En read_link, data siempre está vacío. Si quitas la firma, la petición sigue teniendo éxito, pero la página ya no está. Los códigos de fallo son url_not_accessible, url_not_allowed y unavailable. url_not_allowed también cubre una página que no pasó la revisión de seguridad.
Un elemento de búsqueda de Responses:
{
"type": "web_search_call",
"id": "srvtoolu_s_00_3f2a9c",
"status": "completed",
"kind": "search",
"action": {
"type": "search",
"queries": [
"DeepSeek API 13 November 2026"
],
"sources": [
{
"type": "url",
"url": "https://example.com/news",
"title": "Change log",
"snippet": "Web search and URL reading are now API tools.",
"published_at": "2026-11-13T00:00:00+00:00"
}
]
}
}JSON independiente de Search y Fetch
Cuando es tu código, y no el modelo, quien decide buscar, llama a las API JSON en bruto. Search es POST https://api.deepseek.com/v1/tools/search. query es obligatorio, de 1 a 128 caracteres, no solo espacios. count va de 1 a 50 y por defecto es 10. ori_question es opcional, también de 1 a 128 caracteres. localization es una IP opcional. need_content por defecto es false. Los campos desconocidos se ignoran. Operadores que pasan tal cual: site:, -site:, -, -"...", "...", lang:, after: y before:.
{
"query": "DeepSeek site:api-docs.deepseek.com after:2026-11-01",
"count": 10,
"need_content": false
}Fetch es POST https://api.deepseek.com/v1/tools/fetch. El único campo es url, como máximo 8.192 caracteres, HTTP o HTTPS, con host y sin usuario ni contraseña. El cuerpo es title y content en Markdown. Si no hay título, es una cadena vacía.
{
"url": "https://api-docs.deepseek.com/updates"
}| Campo | Qué guardar |
|---|---|
rerank_score | De 0 a 3. 1,5 o más es la franja de alta calidad de la guía |
authority | De 0 a 4. −1 significa desconocido. 3 o más es muy autoritativo |
snippet / summary | Corto para la interfaz, largo para el modelo |
content | Vacío si need_content no es true, o si la página no tiene contenido |
date | RFC 3339 en UTC, o null |
file_id, OCR y JSON de voz
La entrada de archivos tiene dos pasos. POST https://api.deepseek.com/files, con purpose antes de file. text_recognition descarta gráficos. rich_layout_recognition recorta figuras dentro del texto y gasta tokens de imagen. El objeto de archivo solo vuelve después del análisis. id tiene forma file-api-.... Una desconexión no cancela un análisis que luego tiene éxito: el archivo se guarda y se cobra. No se puede descargar el original ni el análisis. Chat Completions lo referencia así:
{
"role": "user",
"content": [
{
"type": "file",
"file_id": "file-api-xxxxxxxxxxxxxxxx"
},
{
"type": "text",
"text": "Summarize the revenue chart."
}
]
}Messages necesita la cabecera anthropic-beta: files-api-2025-04-14 y un bloque document cuyo source.type es file. Responses usa input_file y file_id. Un documento analizado no se puede enviar como bloque de imagen. Tampoco se pegan los bytes ni una URL de archivo en la petición de chat. Una petición cita como máximo 20 documentos y 8 MiB de texto. El análisis completo permanece en el contexto en turnos posteriores. Si es demasiado largo, 400. Nada se trunca en silencio.
Límites: PDF, Word, PowerPoint e imágenes habituales, el formato se detecta por los bytes. 100 MiB, si no 413. 1.000 páginas. 120 segundos para subir, si no 408. 120 segundos para analizar, si no 504. 15 subidas de documentos en curso por cuenta. Los archivos con contraseña devuelven 400. Texto plano, csv, json, código, xlsx, xls, epub y mobi usan purpose user_data y no se cobran por página. Esos archivos llegan a 32 MiB, y el texto a 8 MiB. AZW3 y los libros con DRM no se admiten.
El análisis cuesta 0,225 $ por cada 1.000 páginas, una vez, solo si tiene éxito. Los turnos de chat posteriores cobran tokens de entrada, no otra vez las páginas. OCR tiene el mismo precio por página en POST /v1/tools/ocr y no entra en la API Files. Es multipart, file más purpose, no un cuerpo JSON. ASR es audio multipart, no JSON. TTS es JSON, POST /v1/tools/tts:
El precio de lista de TTS es 0,45 $ por 10.000 caracteres, y el precio limitado publicado es 0,225 $. Un carácter chino cuenta como 2. Cualquier otro carácter cuenta como 1. Las voces son stella (por defecto) y tide. No hay campo de idioma. El precio de lista de ASR es 0,116 $ por hora de audio, precio limitado 0,058 $, cobrado por segundo, y una fracción se redondea a 1 segundo. La página de precios no da fecha de fin para el medio precio.
{
"text": "Hello from DeepSeek.",
"voice_id": "stella",
"format": "wav",
"filter_markdown": true
}safety_check y JSON de rechazo
Para un servicio al que llega el público, pon safety_check en {"level":"high"}. low equivale a omitir el campo. Cualquier otro nivel es 400. El parámetro no sustituye tus deberes de revisión, registro o etiquetado. Una entrada que no pasa devuelve 400 Content Exists Risk. Esos tokens de entrada se cobran igual, al precio de acierto de caché. Cuando el modelo termina, la conexión sigue abierta mientras se revisa la salida. El texto ya emitido no se puede retirar. Sustituye lo que mostraste. Los tokens usados antes del rechazo se cobran. Los tokens de revisión van dentro de los tokens de salida y también en usage.output_tokens_details.safety_tokens en Messages y Responses, o en usage.completion_tokens_details.safety_tokens en Chat. Una imagen bloqueada puede nombrar una ruta como messages.1.content.0, en stop_details.explanation, un contenido de rechazo o message.refusal. Una petición con las herramientas web y sin safety_check también puede acabar en rechazo.
| API | JSON del rechazo |
|---|---|
| Messages | stop_reason refusal, stop_details.type refusal. Sin flujo se quitan el razonamiento y el texto de respuesta; quedan los bloques de herramientas y un bloque text vacío |
| Responses | status incomplete, incomplete_details.reason content_filter. output solo conserva los web_search_call ya ejecutados |
| Chat | finish_reason content_filter. content es una cadena vacía. annotations se omite. server_tool_calls se queda, y el razonamiento de cada paso se vacía |
Cobrar tool_search, no web_search_requests
Cobra tokens y herramientas en líneas distintas. Los precios Flash son por 1.000.000 de tokens. Las horas punta son 01:00–04:00 y 06:00–10:00 UTC, de lunes a viernes, salvo festivos chinos. Cualquier otra hora es valle, fines de semana y festivos chinos el día entero. El valle es la mitad de la punta. cache_creation_input_tokens se queda en 0.
| Ventana | Acierto de caché / 1M | Fallo de caché / 1M | Salida / 1M |
|---|---|---|---|
| Valle | $0.003 | $0.15 | $0.60 |
| Punta | $0.006 | $0.30 | $1.20 |
La búsqueda y el fetch web cuestan 0,75 $ por cada 1.000 usos con éxito, tanto si el modelo llamó a la herramienta como si tú llamaste a /v1/tools/search o /v1/tools/fetch. Una búsqueda de herramienta con resultados se cobra por consulta, así que tres consultas cuentan como tres. count no cambia el precio de la API Search. Un HTTP 200 con un array results vacío no se cobra. Fetch solo se cobra cuando vuelve el contenido de la página. Una página que la seguridad sustituye después por url_not_allowed o unavailable ya se obtuvo, así que se cobra. Abrir otra vez la misma página en la búsqueda profunda es gratis. find_in_page es gratis.
Search está limitado a 100 peticiones por segundo y por cuenta. Fetch a 25, más un tope por dominio. Los topes son por cuenta, no por clave, y van aparte del límite de concurrencia Flash de 2.500. En la guía, una búsqueda con citas y dos consultas informa web_search_requests 1 y tool_search 2. Guarda tool_search, tool_fetch y tool_image_search. No sumes web_search_requests. En Responses y Chat, server_tool_use omite ese trío cuando los tres son 0.
Si la generación falla cuando el estado HTTP ya es 200, el cuerpo es un error más usage. El flujo de Messages termina en un evento error, sin message_delta después. Revisa el cuerpo. Un SDK no lanza excepción con el estado 200. El ejemplo publicado de esa búsqueda de dos consultas. thinking_tokens y safety_tokens no están en este objeto. Aparecen aparte cuando pensar está encendido, o cuando safety_check es high, y ya van dentro de output_tokens:
{
"input_tokens": 1905,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 72,
"service_tier": "standard",
"server_tool_use": {
"web_search_requests": 1,
"web_fetch_requests": 0,
"tool_search": 2,
"tool_fetch": 0,
"tool_image_search": 0
}
}JSON que hay que revisar antes de publicar
- El cuerpo tiene
deepseek-flash. Las herramientas de Messages incluyentypeyname. Pensar está endisabledsi querías la búsqueda con citas. - Una app pública envía
safety_check.levelhigh.response_formatytext.formatse quedan entexten estas llamadas. - El analizador empareja
tool_use_idykind, y guardasignaturepara el turno siguiente. - La factura usa
tool_search,tool_fetchytool_image_search, más la entrada sin caché, la entrada con caché y la salida. No sumaweb_search_requests. - Una
querysuelta tiene de 1 a 128 caracteres.countva de 1 a 50. Los resultados vacíos no son un cargo.
Revisa el JSON en local con el validador JSON, JSONPath ($.usage.server_tool_use.tool_search) y JSON Diff contra la petición anterior. No se sube nada.
FAQ
¿thinking cambia la búsqueda?
Sí. thinking.type disabled es una búsqueda web con citas y kind es search. enabled es la búsqueda con razonamiento profundo: search, open_page y find_in_page, unas 20 llamadas, y kind es deep_search. Pensar es el valor por defecto. Si pensar y deepseek_web_search están activos, esa ronda no ejecuta deepseek_read_url.
¿tool_choice puede forzar deepseek_web_search?
No. Nombrar la herramienta devuelve 400, deepseek_web_search cannot be forced. Decide el modelo. tool_choice none apaga las herramientas web declaradas, incluida la lectura de URL. En Responses y Chat, required se trata como auto.
¿La factura debe usar web_search_requests?
No. Ese recuento incluye errores y es para mostrar. Cobra tool_search, tool_fetch y tool_image_search. En la guía, un bloque de búsqueda con dos consultas informa web_search_requests 1 y tool_search 2. Una búsqueda con resultados se cobra por consulta. Una búsqueda vacía o fallida no se cobra.
¿POST /v1/tools/search busca imágenes?
No. La búsqueda de imágenes solo corre dentro de deepseek_web_search. kind es image_search o deep_image_search, y queries está vacío. Cada imagen cuenta como una búsqueda, y cada región que elige el modelo cuenta como una más.
¿Qué envía un servicio público para la seguridad?
DeepSeek dice que un servicio abierto al público activa safety_check con level high. low equivale a omitir el campo. Una entrada de riesgo devuelve 400 Content Exists Risk, y esos tokens de entrada se cobran al precio de acierto de caché. Un rechazo es stop_reason refusal, Responses incomplete con content_filter, o Chat finish_reason content_filter.
¿Puedo continuar una respuesta que buscó?
No. Una respuesta que usó deepseek_web_search o deepseek_read_url devuelve 400. Reenvía la petición anterior. En el turno siguiente, devuelve los bloques del asistente sin cambios, incluidos kind y signature. Sin una firma válida la petición sigue teniendo éxito, pero la página no vuelve al contexto.
Resumen
Las herramientas del 13 de noviembre de 2026 cambian la petición, los bloques que guardas y una segunda línea de la factura. Declara deepseek_web_search y deepseek_read_url en deepseek-flash. Apaga pensar para la búsqueda con citas y enciéndelo para la búsqueda profunda. Las apps públicas ponen safety_check.level en high. Cobra tool_search, no web_search_requests.