Respuesta rápida
¿Cómo compruebo que LLMWebSearch funciona?
Llama a GET https://llmwebsearch.com/api/v1/credits con tu clave. Es gratis, no toca ningún sitio web y una respuesta JSON normal demuestra que la API LLMWebSearch, tu clave y tu cuenta funcionan. Después lanza una búsqueda, que cuesta 1 crédito de un pack con un precio desde 1,20 US$/1K búsquedas. Los errores de nuestro lado nunca se cobran, y los incidentes quedan fechados en el changelog.
¿Cuál es la comprobación de estado más rápida?
El endpoint de créditos. Responde solo desde nuestro lado: autenticación, la API y tu cuenta. Si devuelve tus créditos restantes, el servicio está operativo para ti. Si devuelve 401, la clave es incorrecta o ha sido revocada; crea una nueva en el panel.
curl -s https://llmwebsearch.com/api/v1/credits \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"
import os
import sys
import requests
resp = requests.get(
"https://llmwebsearch.com/api/v1/credits",
headers={"Authorization": f"Bearer {os.environ['LLMWEBSEARCH_API_KEY']}"},
timeout=10,
)
if resp.status_code != 200:
print("API check failed:", resp.status_code, resp.text[:200])
sys.exit(1)
print("API up, credits left:", resp.json()["credits_remaining"])
¿Cómo distingo nuestro error del rechazo de un sitio web?
Fíjate en dónde aparece el problema en la respuesta.
- Un error HTTP en toda la llamada (
502 search_failed,504 search_timeout) es de nuestro lado o de un proveedor upstream. No cuesta nada; espera un poco y reintenta con un intervalo que crezca. - Una llamada correcta con algunos resultados sin contenido tiene que ver con esas páginas. Cada resultado lleva un
content_status:blocked_by_robots,blocked_by_site_policy,target_refused,fetch_failedofetch_timeout. La búsqueda en sí funcionó.
El segundo caso es normal en la web abierta y no es un incidente. La página de errores enumera todos los códigos.
¿Dónde se registran los incidentes?
En el changelog. Un incidente que afecta a muchas cuentas recibe una entrada con fecha: qué falló, desde y hasta cuándo, y qué cambió después. Las llamadas que fallaron durante un incidente no se cobraron, así que no hay nada que reclamar.
No publicamos un porcentaje de uptime ni una cifra de latencia. Preferimos darte una comprobación que puedas ejecutar que un número que no puedes verificar.
¿Qué debe hacer mi agente cuando falla una llamada?
Reintenta solo lo que pueda salir bien más adelante. Un 429 rate_limited, 502 search_failed o 504 search_timeout merece un reintento tras una espera corta que se duplique cada vez. Un 401 o 402 necesita a una persona: una clave nueva o más créditos. Una página rechazada por su sitio web no debe reintentarse en absoluto; usa los demás resultados de la misma búsqueda.
Preguntas sobre el estado
¿La llamada de créditos consume algún crédito?
No. GET https://llmwebsearch.com/api/v1/credits es gratis, así que un trabajo de monitorización puede ejecutarla tantas veces como permita tu límite por minuto.
Mi búsqueda funcionó pero un resultado no tiene contenido. ¿Es una caída?
No. Esa página no se pudo leer: su content_status dice por qué. Nuestro lector respeta robots.txt: se identifica como LLMWebSearch, sigue las reglas que un sitio escribe para él o para todos los robots, y deja fuera el contenido de cualquier página que no tenga permitido leer.
¿A quién aviso de un problema que la comprobación de estado no muestra?
Al soporte en [email protected], con la hora, el endpoint y una respuesta fallida completa. Una persona responde en un plazo de 12 horas.