Costos y caché

Lo que cuesta cada pedido

El crédito es prepago y cada pedido se descuenta a precio de lista, en US$ cada 1.000:

Cada consulta de un pedido con varias consultas es una búsqueda de su modo. Contenidos cobra sólo las páginas que se leyeron: una URL que falla no se cobra. usage.cost_usd de cada respuesta dice cuánto se cobró ese pedido, y GET /v1/usage devuelve la lista en pricing. Un gráfico cuesta su búsqueda por consulta más el adicional (desde $1,50 cada 1.000 en ultra); ver su embed, su imagen o su SVG es gratis, y también GET, PATCH y DELETE sobre los gráficos.

Topes

Pon max_tokens en un pedido (mínimo 2000) y nunca gastará más. El presupuesto se reserva antes de cada llamada al modelo; cuando la siguiente no entra, la búsqueda se detiene y devuelve todo lo juzgado hasta ahí con incomplete: true.

const res = await ts.search('el dólar', { mode: 'deep', max_tokens: 15_000 });

if (res.incomplete) {
  console.log(`Se detuvo en ${res.budget?.used} de ${res.budget?.max_tokens} tokens`);
}

Si el tope no alcanza ni para juzgar los titulares, el pedido falla con 402 budget_too_small antes de gastar nada.

Lo que no pagas dos veces

• Caché de resultados. Un pedido idéntico dentro de los 10 minutos sale de la caché: cached_at dice cuándo se calculó, usage.tokens es 0 y no se cobra. Pon fresh: true para saltarla. El mismo pedido de gráfico dentro de 10 minutos devuelve el mismo gráfico con cached: true, también gratis.
• Pedidos fallidos. Un pedido que falla de nuestro lado no se cobra, ni un gráfico que no encontró notas sobre su tema (422 insufficient_data). La mejora de un gráfico que volvió con improving también es gratis.
• Memoria de juicios. Lo que el modelo dijo de un titular para una consulta se recuerda durante una semana, y el tono de cada nota también. Una búsqueda repetida sólo paga los titulares nuevos.
• Primero los filtros. Dominios, secciones y fechas se aplican antes de juzgar nada.
• Varias consultas juntas. Hasta cinco consultas en un pedido comparten las mismas llamadas al modelo.

Cuánto gastas

Cada respuesta de búsqueda trae un objeto usage con los tokens del modelo, las llamadas, la duración y el cost_usd de ese pedido. GET /v1/usage devuelve tus totales de hoy y de los últimos 30 días, tus límites y la lista de precios.