Conectar OpenAI a JMAX: la clave, el catálogo y los tres fallos que había

Guía hecha sobre la certificación real del 11 de septiembre de 2026, con la clave del cliente y el ejecutable instalado (JMAX v0.2.4, 262 herramientas). Las capturas son las de esa sesión, en tomas/.

Vídeo tutorial: 33 · Conectar OpenAI.

Lo que hay que saber antes de empezar (2026)

1. La clave se crea en https://platform.openai.com/api-keys y empieza por sk-proj-. Se muestra una sola vez: si se pierde, se crea otra.
2. La cuenta necesita saldo. Sin créditos, cualquier modelo contesta 429 insufficient_quota aunque la clave sea buena.
3. El endpoint es https://api.openai.com/v1 y ya viene puesto. No hay que tocarlo salvo que uses una pasarela propia.
4. No todos los modelos del catálogo conversan. Una cuenta normal devuelve unos 130: además de los gpt-* vienen los de voz (-tts, -transcribe), los de imagen (gpt-image-*), los de código (-codex) y restos antiguos de completado (babbage-002, davinci-002, -instruct). Estos últimos no aceptan /chat/completions.

Pasos

1. Abrir la tarjeta de OpenAI

Menú → Gestión y Administración → Proveedores → tarjeta OpenAI.

2. Pegar la clave

Campo API key → pegar → Guardar clave. A partir de ahí el campo enseña •••••••• (guardada): la clave no vuelve a salir por pantalla ni viaja a la interfaz.

3. Comprobar el catálogo vivo

Al guardar, JMAX le pregunta a OpenAI qué modelos tiene esa cuenta y los guarda. En el caso real llegaron 130. Arriba, en Datos personales hacia este proveedor, se elige qué sale del equipo; lo recomendado es Enviarlos sustituidos por marcadores (seudonimizar).

4. Probar conexión

✓ chat-latest respondió en 3183 ms.

5. Repartir los roles

Rol	Modelo	Por qué
Cerebro grande	gpt-5	el trabajo con herramientas y búsqueda
Rápido	gpt-4o-mini	responde por debajo del segundo y cuesta poco
Respaldo	gpt-4o-mini	mismo motor, sin depender de la cuota del grande
Visión	gpt-4o-mini	mira imágenes y fotogramas de vídeo
Datos personales	seudonimizar	ver más abajo

6. Prueba de uso real

Encargo: «Busca en internet qué es el modelo GPT-5 de OpenAI y resúmelo en tres líneas con su enlace.»

Ocho pasos (cerebro grande → cuatro búsquedas → dos páginas leídas → redacción), 9 fuentes consultadas y 1 min 5 s.

Los tres fallos que se corrigieron en esta certificación

Con una clave perfectamente válida, JMAX decía «No pude hablar con el proveedor, comprueba tu internet». Eran tres cosas distintas, y las tres están arregladas:

1. Se probaba el modelo equivocado. La lista venía en orden alfabético y el primero era babbage-002, un modelo de completado que no acepta chat → 400. Ahora _conversan_primero() pone delante los que conversan y deja al final los de voz, imagen, código y completado.
2. El error real se perdía. LLMError no llevaba el código de estado, así que cualquier fallo acababa en el mensaje genérico de red. Ahora LLMError hereda de ErrorProveedor y conserva el estado; _explicar_fallo() traduce 400-499 a «la petición no le gustó» y 5xx a «el proveedor está fallando», en los seis idiomas.
3. gpt-5 rechazaba max_tokens. Los gpt-5, chat-latest y la serie o exigen max_completion_tokens (Unsupported parameter: 'max_tokens' is not supported with this model). El cliente ahora detecta ese mensaje, renombra el campo y reintenta una vez.

Seudonimización y datos personales

El prompt del sistema lleva el nombre y el correo del registro del equipo. Con el modo bloquear («No enviarlos nunca») eso basta para que todos los turnos se queden en el cerebro local y OpenAI no conteste nunca. Para probar la nube hay que usar seudonimizar: los nombres, documentos y teléfonos salen como [PERSONA_1], [DOCUMENTO_1]… y vuelven con el valor real. Salud, contraseñas y tarjetas nunca salen, se elija lo que se elija.

Revocar una clave

https://platform.openai.com/api-keys → la clave → Revoke. Hazlo con cualquier clave que hayas pegado en un chat, un correo o un ticket.