Tokens y contexto: cómo interpretar el uso de una API de IA

Antes de empezar

Nivel principiante. Necesitas Node.js, el programa que ejecuta JavaScript en tu ordenador, y un editor de texto. No necesitas cuenta ni clave.

Abre una terminal: una ventana donde escribes órdenes para tu ordenador. Sitúate en la carpeta del archivo.

Un token es una unidad de información que procesa un modelo. Puede corresponder a parte de una palabra.

El contexto es la información que recibe: instrucciones, mensajes y otros datos.

La ventana de contexto limita esa información según el modelo. No equivale al máximo de respuesta.

1. Guarda el registro de práctica

Guarda el bloque en uso.mjs. Suma dos números inventados para explicar la separación entre entrada y salida.

input_tokens representa la entrada; output_tokens, la salida. El ejemplo no divide texto en tokens ni consulta una API.

// Registro sintético; no cuenta tokens ni estima una factura.
const usage = { input_tokens: 120, output_tokens: 30 };
for (const value of Object.values(usage)) {
  if (!Number.isSafeInteger(value) || value < 0) {
    throw new Error("Uso inválido");
  }
}
const total = usage.input_tokens + usage.output_tokens;
console.log("Entrada: " + usage.input_tokens
  + "; salida: " + usage.output_tokens + "; total: " + total);

Entrada: 120; salida: 30; total: 150

Qué deberías ver: Un archivo uso.mjs con ambos campos. Comprueba que los números son enteros y no negativos.

2. Ejecuta la suma

Escribe node uso.mjs en la terminal. El programa comprueba los números y muestra su suma.

Qué deberías ver: Entrada: 120; salida: 30; total: 150. Son valores del ejercicio, no límites ni consumos de un proveedor.

3. Selecciona la información necesaria

Haz una lista de los datos que necesita tu tarea. Evita incluir archivos completos si solo necesitas un apartado.

Comprueba que los recortes conservan la información necesaria. Una petición más pequeña puede fallar si pierde datos importantes.

Qué deberías ver: Una lista breve de instrucciones y datos que justifican cada parte de la entrada.

4. Consulta las condiciones del proveedor

Revisa la ficha oficial del modelo antes de calcular un presupuesto. Comprueba las categorías de uso y sus tarifas vigentes.

En una integración real, lee los campos documentados por su API, el contrato para pedir operaciones.

Conserva la fecha del cálculo. Un total de tokens no basta para conocer una factura.

Qué deberías ver: La fuente oficial y la fecha que respaldan tu cálculo. Esta guía no fija precios ni promete un coste.

Errores comunes

Cuentas palabras como tokens: consulta el contador compatible con tu modelo o el uso que devuelve el proveedor.

Tratas todo el consumo igual: separa las categorías documentadas antes de aplicar sus tarifas.

Recortas información y empeoran las respuestas: recupera los datos necesarios y repite los mismos casos de prueba.

Qué has aprendido

Distingues entrada, salida y contexto. Puedes leer el ejercicio sin confundir sus números con uso real o dinero.

Siguiente paso

Continúa con cómo validar una respuesta json antes de usarla.