OpenAI y OpenAI Image

OAR ofrece dos proveedores que funcionan con tu propia clave de API de OpenAI, y guardas la clave una sola vez para ambos.

• OpenAI (BYOK) es un agente de programación. Es la runtime de GitHub Copilot, dirigida a la API de OpenAI (o a un endpoint compatible) con tu clave en lugar de los modelos de un plan de Copilot. Lee archivos, ejecuta comandos y edita código como una conversación de Copilot.
• OpenAI Image (BYOK) no es un agente. Es un chat en el que cada mensaje se convierte en una solicitud a la API Images de OpenAI, y cada respuesta es una o varias imágenes.

Ambos se facturan a tu cuenta de OpenAI. El agente de OpenAI necesita la CLI de GitHub Copilot en el host del relay, porque lo ejecuta la runtime de Copilot; consulta GitHub Copilot. El proveedor de imágenes no usa la CLI de Copilot.

Configurarlo #

Abre Settings → Providers → OpenAI (Ajustes → Proveedores → OpenAI).

Pulsa Save OpenAI settings (Guardar los ajustes de OpenAI). El relay pide entonces al endpoint su lista de modelos (/models bajo la URL base) y añade lo que encuentra a los selectores de modelo. Si eso falla, los ajustes se guardan igualmente y una notificación dice por qué; los modelos anteriores se mantienen.

La clave se almacena en la base de datos del relay en el host. El campo no vuelve a mostrarla nunca: una vez guardada una clave, su texto de ejemplo dice Saved API key (enter to replace). Déjalo en blanco para conservar la clave guardada, o escribe una nueva para reemplazarla.

La línea de estado bajo los campos te dice en qué punto estás:

OpenAI API is enabled. Select OpenAI in New Chat to use model gpt-4o.
API key saved but currently disabled. Enable it to allow OpenAI selection in New Chat.
Not configured. New conversations use GitHub Copilot.

Desactivarlo o quitar la clave #

Aquí los chats de imágenes cuentan como conversaciones de OpenAI. En la práctica, la clave solo se puede quitar una vez eliminadas todas las conversaciones de OpenAI u OpenAI Image que tengan algún mensaje. Si solo quieres dejar de tener chats nuevos de OpenAI, desactiva el interruptor en su lugar. Las conversaciones de otros proveedores no importan.

Otro endpoint #

Pon en Base URL la dirección de cualquier endpoint que hable la API de OpenAI, por ejemplo https://llm.example.com/v1, y en OpenAI API key la clave que espera ese endpoint. El agente habla con él para las conversaciones, y el relay para la detección de modelos y para las imágenes. Volver a guardar la dirección predeterminada borra el valor almacenado.

El agente necesita un modelo que admita llamadas a herramientas y streaming, con una ventana de contexto de al menos 128k tokens para obtener los mejores resultados. Ese es el requisito de la CLI de Copilot para cualquier modelo con clave propia; OAR no lo comprueba. Un chat de imágenes necesita un endpoint con la ruta de generación de imágenes y, para las ediciones, la ruta de edición de imágenes, y que liste un modelo de imagen.

OpenAI, el agente #

Elige OpenAI (BYOK) como Provider (Proveedor) en New Chat. La lista de modelos es la guardada para tu clave. La conversación se comporta entonces como una conversación de Copilot: el mismo selector de modo, la queue, la corrección del rumbo, las tarjetas de pregunta y las herramientas de archivos. Consulta Iniciar una conversación para el cuadro de diálogo y Modos del relay para los modos.

Lo que se deriva de funcionar sobre la runtime de Copilot:

• El motor de Copilot decide las funciones. Es la opción para todo el relay en Settings → Providers → Copilot → Copilot engine (Ajustes → Proveedores → Copilot → Motor de Copilot), que se lee cuando arranca el worker de una conversación. La corrección del rumbo, el panel de tareas en segundo plano y las tarjetas de pregunta dependen de él; consulta GitHub Copilot.

• El modelo queda fijado. Después del primer mensaje, el área de redacción queda bloqueada en el modelo con el que empezó la conversación, y la nota sobre el campo de entrada lo indica.

• El reasoning effort depende del modelo. Las opciones de Reasoning effort siguen el nombre del modelo. La primera opción está preseleccionada salvo que la última vez usaras otra.

  El nombre del modelo empieza por	Opciones
  gpt-5, codex	none, low, medium, high, xhigh
  o1, o3, o4	low, medium, high
  cualquier otra cosa	none

• Formato de transmisión. Los modelos gpt-5, codex-, o1, o1-, o3, o3- y o4- usan la Responses API; los demás usan Chat Completions. Esto importa si tu endpoint solo admite una de las dos.

• Sin consumo del plan. Los turns de OpenAI no tienen línea de consumo bajo la respuesta ni entrada en Check Usage (Ver consumo); esas son solo para Copilot. La compactación, los reinicios y la reanudación funcionan como en Copilot: consulta Compactación y Reinicios y reanudación.

OpenAI Image, el chat de imágenes #

Un chat de imágenes sirve para crear y retocar imágenes a partir de una descripción. No hay agente: el relay envía tu mensaje a la API Images y muestra en el chat lo que vuelve.

Iniciar uno #

1. Abre New Chat y pon Provider en OpenAI Image (BYOK). Aparece junto a OpenAI (BYOK) en cuanto OpenAI está activado.
2. Elige un Model (Modelo). Solo se listan modelos de imagen: aquellos cuyo nombre empieza por gpt-image- o dall-e-. La detección de modelos del relay solo conserva los nombres que empiezan por gpt-, chatgpt-, o1, o3, o4-, codex- u openai/, así que los modelos gpt-image-* se encuentran en tu endpoint, pero un modelo dall-e-* solo aparece si introduces su ID como OpenAI model ID. Si no se lista ningún modelo de imagen, no hay nada que elegir.
3. Fija Quality y Size (Calidad / Tamaño).
4. Pulsa Start chat (Iniciar chat) y luego describe la imagen.

Un chat con un modelo que no es de imagen se rechaza: OpenAI image provider requires an image model (received "model-name").

Lo «usado la última vez» se recuerda por navegador. En el chat abierto, el área de redacción mantiene los dos como selectores: la calidad en el lugar del reasoning effort, con el título Quality, y el tamaño, con el título Image size (Tamaño de imagen). Así puedes cambiarlos de un mensaje a otro. Cada mensaje crea una imagen. La calidad y el tamaño también se fijan en Iniciar una conversación.

Edición y mensajes de seguimiento #

Un mensaje nuevo es una imagen nueva. Para retocar una que ya tienes, usa Edit this image (Editar esta imagen) bajo ella:

1. Pulsa Edit this image bajo la imagen. Un chip encima del área de redacción dice Editing (Editando) y el nombre de la imagen, con un botón para cancelar, y el campo de entrada pide Describe how to edit this image….
2. Escribe qué cambiar y envíalo. El relay envía esa imagen exacta y tu texto a la ruta de edición de la API Images, y la imagen nueva aparece como respuesta.
3. La imagen nueva también tiene Edit this image, y un enlace Edited from previous image (Editada a partir de la imagen anterior) que vuelve a la imagen de la que procede.

Como la edición parte de la imagen bajo la que pulsaste el botón, puedes ramificar: editar de nuevo una imagen anterior sin que vengan las posteriores. El chip desaparece después de enviar el mensaje.

También puedes adjuntar una imagen tuya a un mensaje en un chat de imágenes. La primera imagen adjunta es la que se edita. Solo se usa la primera.

Dónde se guardan las imágenes #

El relay guarda cada imagen generada como un archivo en el host, en la carpeta de estado de sesión de la CLI de Copilot (~/.copilot/session-state, o la carpeta indicada por COPILOT_SESSION_STATE_DIR), bajo la conversación. Las muestra en el chat desde ahí, y un enlace compartido de solo lectura también las muestra. Se conservan mientras exista la conversación; eliminar la conversación elimina sus imágenes.

Lo que no tiene un chat de imágenes #

La solicitud es solo tu texto y, para una edición, una imagen. Así que no hay carpeta de trabajo que leer o escribir, ni herramientas, ni preguntas de un agente, ni corrección del rumbo de un turn en curso, ni tareas en segundo plano, ni compactación. El selector de modo sigue mostrándose, pero no tiene efecto; consulta Modos del relay. En el host del relay no se ejecuta nada salvo la solicitud.

Si una solicitud falla, el chat muestra el motivo en la respuesta. Un fallo que el endpoint informa como error del cliente (estado de 400 a 499) no se reintenta; el turn falla con Error code: relay.image-provider-rejected. Un error de red o un error del servidor se reintenta. Si el relay se interrumpe después de que una imagen pueda haberse creado ya, no se vuelve a ejecutar, para evitar duplicados.

Costes #

Ambos proveedores se facturan a tu cuenta de OpenAI, o a la cuenta a la que pertenezca tu endpoint. OAR no lo mide: los turns de OpenAI no tienen línea de consumo ni entrada en Check Usage, y las solicitudes de imágenes no muestran ningún coste. Vigila tu gasto en el panel de tu proveedor. Un mensaje de imagen hace una solicitud de imagen; un turn del agente puede hacer muchas solicitudes al modelo, porque cada paso con herramientas es otra ida y vuelta.

Comparación #

Si no funciona #