Cómo consulta Firmín a Jev

Jev

Jev (typesafe/jev-1.13; ahora responde typesafe/jev-1.13-20260917) es un modelo de TypeSafe al que Firmín llega a través de la Decisions API de OpenRouter:

POST https://openrouter.ai/api/alpha/decisions

No escribe texto. Recibe un contexto (state) y preguntas cerradas (questions), cada una con sus opciones y lo que significa cada una (criteria). Para cada pregunta devuelve la opción que elige y la probabilidad de cada opción. Firmín usa las probabilidades.

Para cada campo, dos preguntas:

• quien_N: de quién es el dato. 6 opciones: titular, representante, otra persona, firma, trámite o nadie.
• que_N: qué dato es. 75 opciones: NIF, primer apellido, código postal, IBAN, día de la firma…

Las dos respuestas dan una etiqueta, como titular.nif, domicilio.cp o firma.dia, con su probabilidad. Las opciones, con el texto que recibe Jev, están al final.

Cuándo se usa

De un formulario a las consultas

1. Campos. Firmín lee los campos del PDF, o los dibuja si no tiene. Una fila de cajitas de un carácter (un NIF, un IBAN) cuenta como un campo. Cada campo tiene un número, el #N de las preguntas.
2. Lotes. Los campos de cada página van de diez en diez. Cada lote es una consulta, y todas salen a la vez.
3. Contexto. Cada consulta lleva los campos del lote, los que tienen cerca por encima y por debajo, y el resto de su apartado, que dice de quién es un bloque. En orden de lectura, hasta 80.
4. Etiqueta. De todas las parejas de quién y qué que tienen sentido, Firmín se queda con la de mayor probabilidad: la de quién por la de qué. Firma e IBAN, por ejemplo, no tiene sentido.
5. Reglas. Corrigen lo que Jev confunde: dos campos de «apellidos» en una línea son el primero y el segundo; en «En … a … de … de …», el orden dice cuál es el lugar, el día, el mes y el año.

La consulta

Lleva la clave en la cabecera Authorization: Bearer …. El cuerpo:

De cada campo se envía:

No se envían tus datos, tu certificado, lo que se va a escribir, lo que ya tiene escrito el formulario ni el PDF.

La respuesta

En answers, una entrada por pregunta: choice, la opción elegida; probabilities, la de cada opción; y confidence. En usage, los tokens y el coste en dólares. Si OpenRouter no responde con un 200, los campos de ese lote se quedan sin etiqueta.

Con la probabilidad de la etiqueta, Firmín decide:

Los datos del banco se proponen siempre. Si un dato sale dos veces (el NIF, el código postal), solo el primero se escribe solo: el segundo suele ser de otra persona.

Ejemplo: la fecha de la firma

Formulario instancia-algeciras, del 2026-10-08. 4639 tokens de entrada y 1503 de salida: 0,00017 € (0,000195 US$).

Se pregunta por los campos #21 y #22, en la línea «En Algeciras, a ___ de ___ de 20___». Van como contexto el #19, de su apartado, y el #20, que está en la misma línea.

Lo que se envía

{
  "model": "typesafe/jev-1.13",
  "state": {
    "documento": "Formulario administrativo español «instancia-algeciras». Hay que decidir, para cada campo, de quién es el dato que va en él y qué dato es.",
    "campos_cercanos": [
      {
        "campo": "#19",
        "texto_mas_arriba": "3 DOCUMENTACIÓN QUE APORTA",
        "nombre_interno": "Documentación",
        "posicion": "x=52 y=188 (y mayor = más arriba)",
        "pagina": 1,
        "cabecera": "3 DOCUMENTACIÓN QUE APORTA",
        "rotulos_encima": [
          "3 DOCUMENTACIÓN QUE APORTA"
        ],
        "tipo": "texto"
      },
      {
        "tipo": "texto",
        "posicion": "x=108 y=78 (y mayor = más arriba)",
        "campo": "#20",
        "nombre_interno": "Día",
        "texto_izquierda": "En Algeciras, a",
        "texto_derecha": "de de",
        "pagina": 1
      },
      {
        "nombre_interno": "Mes",
        "tipo": "texto",
        "campo": "#21",
        "pagina": 1,
        "texto_izquierda": "En Algeciras, a de",
        "posicion": "x=179 y=78 (y mayor = más arriba)",
        "texto_derecha": "de 20"
      },
      {
        "texto_izquierda": "a de de 20",
        "campo": "#22",
        "nombre_interno": "Año",
        "tipo": "texto",
        "posicion": "x=300 y=78 (y mayor = más arriba)",
        "pagina": 1
      }
    ]
  },
  "questions": {
    "quien_21": {
      "type": "choice",
      "instructions": "¿De quién es el dato que va en el campo #21?",
      "criteria": { las 6 opciones de «quién», abajo }
    },
    "que_21": {
      "type": "choice",
      "instructions": "¿Qué dato va en el campo #21?",
      "criteria": { las 75 opciones de «qué», abajo }
    },
    "quien_22": {
      "type": "choice",
      "instructions": "¿De quién es el dato que va en el campo #22?",
      "criteria": { las 6 opciones de «quién», abajo }
    },
    "que_22": {
      "type": "choice",
      "instructions": "¿Qué dato va en el campo #22?",
      "criteria": { las 75 opciones de «qué», abajo }
    }
  },
  "provider": {
    "data_collection": "deny"
  }
}

Lo que responde Jev

{
  "id": "gen-dec-1791441524-HT2uMZ71eRyFzdYW75K9",
  "model": "typesafe/jev-1.13-20260917",
  "provider": "TypeSafe",
  "answers": {
    "quien_21": {
      "type": "choice",
      "choice": "firma",
      "probabilities": {
        "firma": 0.96,
        "titular": 0.04
      },
      "confidence": 0.95
    },
    "que_21": {
      "type": "choice",
      "choice": "mes",
      "probabilities": {
        "mes": 1
      },
      "confidence": 1
    },
    "quien_22": {
      "type": "choice",
      "choice": "firma",
      "probabilities": {
        "firma": 0.91,
        "nadie": 0.01,
        "titular": 0.07,
        "tramite": 0.01
      },
      "confidence": 0.89
    },
    "que_22": {
      "type": "choice",
      "choice": "anio",
      "probabilities": {
        "anio": 1
      },
      "confidence": 1
    }
  },
  "usage": {
    "input_tokens": 4639,
    "output_tokens": 1503,
    "cost": 0.000194838
  }
}

Lo que hace Firmín

Los dos son de la firma, con más del 80 %, y Firmín escribe el mes y el año del día en que firmas, como persona y como empresa.

Ejemplo: el representante y un campo dudoso

Formulario espacios-culturales-valencia, página 2, del 2026-10-08. 6644 tokens de entrada y 2263 de salida: 0,000243 € (0,000279 US$).

Una declaración responsable con el nombre y el DNI del representante, y un campo detrás de «València,» que es la fecha de la firma.

Lo que se envía

{
  "model": "typesafe/jev-1.13",
  "state": {
    "documento": "Formulario administrativo español «espacios-culturales-valencia». Hay que decidir, para cada campo, de quién es el dato que va en él y qué dato es.",
    "campos_cercanos": [
      {
        "posicion": "x=39 y=753 (y mayor = más arriba)",
        "tipo": "texto",
        "pagina": 2,
        "texto_mas_arriba": "4 Declaració responsable / Declaración responsable Nom i cognoms de la persona representant / Nombre y apellidos de la persona representante DNI-NIE-PAS.",
        "cabecera": "DNI-NIE-PAS.",
        "nombre_interno": "representant",
        "texto_encima": "Nom i cognoms de la persona representant / Nombre y apellidos de la persona repr",
        "campo": "#30",
        "rotulos_encima": [
          "DNI-NIE-PAS."
        ]
      },
      {
        "tipo": "texto",
        "posicion": "x=450 y=753 (y mayor = más arriba)",
        "texto_mas_arriba": "DNI-NIE-PAS.",
        "pagina": 2,
        "rotulos_encima": [
          "DNI-NIE-PAS."
        ],
        "nombre_interno": "dni-nie-pas",
        "texto_encima": "DNI-NIE-PAS.",
        "campo": "#31",
        "cabecera": "DNI-NIE-PAS."
      },
      {
        "pagina": 2,
        "tipo": "texto",
        "texto_mas_arriba": "ón de datos",
        "nombre_interno": "Data3",
        "texto_izquierda": "çant correu electrò- litat de responsable, per a la finalitat indicada València,",
        "posicion": "x=414 y=165 (y mayor = más arriba)",
        "campo": "#32"
      }
    ]
  },
  "questions": {
    "quien_30": {
      "type": "choice",
      "instructions": "¿De quién es el dato que va en el campo #30?",
      "criteria": { las 6 opciones de «quién», abajo }
    },
    "que_30": {
      "type": "choice",
      "instructions": "¿Qué dato va en el campo #30?",
      "criteria": { las 75 opciones de «qué», abajo }
    },
    "quien_31": {
      "type": "choice",
      "instructions": "¿De quién es el dato que va en el campo #31?",
      "criteria": { las 6 opciones de «quién», abajo }
    },
    "que_31": {
      "type": "choice",
      "instructions": "¿Qué dato va en el campo #31?",
      "criteria": { las 75 opciones de «qué», abajo }
    },
    "quien_32": {
      "type": "choice",
      "instructions": "¿De quién es el dato que va en el campo #32?",
      "criteria": { las 6 opciones de «quién», abajo }
    },
    "que_32": {
      "type": "choice",
      "instructions": "¿Qué dato va en el campo #32?",
      "criteria": { las 75 opciones de «qué», abajo }
    }
  },
  "provider": {
    "data_collection": "deny"
  }
}

Lo que responde Jev

{
  "id": "gen-dec-1791441521-vvJ8urnwisP7ZZiBiJhG",
  "model": "typesafe/jev-1.13-20260917",
  "provider": "TypeSafe",
  "answers": {
    "quien_30": {
      "type": "choice",
      "choice": "representante",
      "probabilities": {
        "representante": 0.99,
        "titular": 0.01
      },
      "confidence": 0.99
    },
    "que_30": {
      "type": "choice",
      "choice": "nombre_completo",
      "probabilities": {
        "nombre_completo": 0.99,
        "persona_contacto": 0.01
      },
      "confidence": 0.99
    },
    "quien_31": {
      "type": "choice",
      "choice": "representante",
      "probabilities": {
        "representante": 0.95,
        "titular": 0.05
      },
      "confidence": 0.92
    },
    "que_31": {
      "type": "choice",
      "choice": "nif",
      "probabilities": {
        "nif": 1
      },
      "confidence": 1
    },
    "quien_32": {
      "type": "choice",
      "choice": "titular",
      "probabilities": {
        "nadie": 0.04,
        "representante": 0.07,
        "firma": 0.2,
        "tramite": 0.07,
        "titular": 0.59,
        "otra_persona": 0.03
      },
      "confidence": 0.51
    },
    "que_32": {
      "type": "choice",
      "choice": "email",
      "probabilities": {
        "municipio": 0.04,
        "lugar": 0.04,
        "fecha": 0.28,
        "email": 0.59,
        "domicilio_completo": 0.01,
        "contacto_completo": 0.04
      },
      "confidence": 0.58
    }
  },
  "usage": {
    "input_tokens": 6644,
    "output_tokens": 2263,
    "cost": 0.000279048
  }
}

Lo que hace Firmín

Como persona no hay representante, y su nombre y su DNI quedan en blanco. Como empresa, quien firma es el representante, y Firmín escribe su nombre y su DNI.

En el #32 Jev duda. La mejor etiqueta, contacto.email, se queda en un 35 % y el campo queda en blanco. Lo correcto era la fecha, a la que Jev daba un 28 %.

La clave

La clave es tuya: se crea en openrouter.ai/keys y se pega en Opciones. Antes de guardarla en el llavero, Firmín pregunta a OpenRouter si vale:

GET https://openrouter.ai/api/v1/key
Authorization: Bearer sk-or-v1-…

Con un 200 la guarda; con un 401 o un 403 avisa de que no vale. De la respuesta no lee nada más.

El registro

Cada consulta se apunta en ~/Library/Logs/Firmin-IA.jsonl, con el cuerpo enviado y el recibido tal cual, sin la clave. En Opciones → Uso de la IA se ve cada una: cuándo, qué formulario, cuántos campos, los tokens, el coste y lo que se envió y llegó.

Lo que cuesta

Una consulta lleva una mediana de 23.341 tokens de entrada y 7523 de salida. Todas las consultas del banco, con lo que se envió y lo que respondió Jev, están en cada formulario del banco de pruebas; allí se publican sin las opciones de 0 %.

Las opciones