Saltar al contenido principal

Conectar OpenAI a JMAX

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​

RolModeloPor qué
Cerebro grandegpt-5el trabajo con herramientas y búsqueda
Rápidogpt-4o-miniresponde por debajo del segundo y cuesta poco
Respaldogpt-4o-minimismo motor, sin depender de la cuota del grande
Visióngpt-4o-minimira imágenes y fotogramas de vídeo
Datos personalesseudonimizarver 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.