Integración de IA con tu propia clave (BYOK)

OpenAI permite generar imágenes, usar fondos transparentes y utilizar Mejorar detalles con IA. Google Gemini genera ilustraciones a partir de un prompt; la integración actual no ofrece para Gemini fondos transparentes ni mejora de detalles con IA. Puedes eliminar después el fondo de una imagen de Gemini con las herramientas de Designer.

Anthropic Claude se utiliza para tareas de texto. En el Designer local de WordPress puede preparar un conjunto con texto, vectores simples y un código QR cuando desactivas la capa Imagen. No sustituye a un modelo que genera ilustraciones de mapa de bits.

El catálogo siguiente muestra los modelos compatibles con la integración actual. En el plugin de WordPress eliges el modelo de texto y el de imagen en Detalles de la conexión. En la aplicación Alter Product eliges una conexión y la configuración del servicio asigna el modelo - la ventana del generador no tiene un selector de modelos independiente.

La configuración predeterminada de OpenAI utiliza gpt-5.4-mini para texto y gpt-image-2.5-sunburst para imágenes. En Gemini son gemini-3.5-flash-lite y gemini-3.1-flash-image. La posibilidad de usar un modelo concreto también depende de su disponibilidad y de los permisos de tu cuenta de API.

Abre Ajustes de IA, elige el proveedor y el uso Generación de imágenes y añade tu clave API. Un nombre opcional ayuda a distinguir las conexiones, por ejemplo una cuenta de empresa de otra para probar ideas. Acepta la información sobre costes y selecciona Añadir clave.

Si hay varias conexiones activas, el generador permite seleccionarlas por nombre. En los ajustes también puedes elegir una conexión predeterminada, cambiar su nombre o clave, desactivarla o eliminarla. No necesitas añadir otra clave para prompts al crear un conjunto de capas con una imagen.

Guardar una conexión no genera contenido. La clave se almacena cifrada en el servidor; la interfaz solo muestra sus últimos caracteres. Eliminar una conexión de Alter Product no revoca la clave en la cuenta del proveedor.

Indica qué debe representar la imagen, cómo deben distribuirse los elementos y qué colores deben predominar. Para una impresión, conviene precisar si debe verse el motivo completo, el espacio libre a su alrededor y si debe incluir texto. El campo del prompt admite hasta 500 caracteres.

Puedes partir de un ejemplo situado bajo el campo del prompt y adaptarlo a tu producto. Si quieres una inscripción concreta, escribe su contenido entre comillas y activa la capa Texto. Elige un estilo acorde con la descripción - el ajuste de estilo tiene prioridad sobre una instrucción contradictoria en el prompt.

Despliega Capas y marca solo los elementos necesarios. Imagen y Texto están activados inicialmente. Para una única ilustración, deja solo Imagen. Añade los demás tipos de capas si quieres una composición que puedas seguir ajustando.

El texto en la imagen y la capa Texto producen resultados diferentes. La primera opción permite letras dentro del mapa de bits. La segunda crea textos independientes que puedes modificar después con las herramientas de texto. Para un eslogan que quieras editar, elige la capa Texto.

Tras activar Código QR, introduce el contenido o la URL en el campo correspondiente. Describir el aspecto del código en el prompt no sustituye este paso. Después de insertarlo, comprueba su contenido y lectura en el diseño final.

Elige Cuadrado, Vertical u Horizontal, con proporciones de 1:1, 2:3 o 3:2, respectivamente. Adapta el formato a la impresión: un motivo vertical para el frontal de una camiseta, una composición horizontal para un producto ancho o un cuadrado para una imagen versátil.

Dispones de 31 estilos predefinidos y del estilo Personalizado, donde puedes escribir tu propia descripción de hasta 500 caracteres. Da coherencia a tu colección usando el mismo estilo y una paleta similar en los siguientes prompts.

El fondo puede seguir el prompt, tener un color elegido o ser transparente. Selecciona la transparencia en los ajustes si necesitas solo el motivo para imprimir. En la integración actual esta opción requiere OpenAI; para Gemini, elige el fondo del prompt o un color. Revisa siempre el resultado antes de usarlo.

Utiliza las descripciones siguientes como punto de partida. Define el estilo, el fondo y las capas en el formulario y centra el prompt en el motivo y la composición. Estos ejemplos no garantizan un resultado idéntico en cada generación.

Haz clic en una miniatura para ver una vista previa ampliada. En el menú del resultado encontrarás Copiar prompt y Volver a generar. Al copiarlo, puedes volver a la descripción y cambiar, por ejemplo, la paleta, el tema o el texto antes de generar de nuevo.

Volver a generar prepara un resultado nuevo con los ajustes guardados. Utiliza la conexión original y su clave actual, por lo que la conexión debe seguir disponible. Es una nueva solicitud al proveedor que puede tener coste, no la descarga de una copia de la imagen anterior.

Si el resultado es parcial, revisa los mensajes y las capas presentes. Puedes utilizar los elementos disponibles, pero antes de guardar comprueba el texto, el QR, el fondo y la composición completa. El historial permite ver e insertar conjuntos guardados incluso después de desactivar la clave.

Ampliar imagen prepara una versión más grande del mapa de bits sin una nueva llamada al proveedor de IA. En la implementación actual, el lado más largo se duplica hasta un máximo de 4096 px. La función se aplica a resultados que contienen una imagen.

Para trabajar en la escena puede mantenerse una vista previa más ligera, mientras el archivo más grande se usa para imprimir. El texto independiente, los vectores y la disposición de las capas no cambian. Si el resultado ya está en el proyecto, se le puede asociar el archivo de impresión más grande.

Más píxeles no garantizan recuperar los detalles finos del original ni imprimir correctamente a cualquier tamaño. Revisa la imagen con las dimensiones de impresión previstas y elige los parámetros de exportación en el Gestor de impresión.

Para un resultado de OpenAI compatible, elige Mejorar detalles con IA. Introduce una Descripción de los cambios, como «define los contornos del pelo y conserva la composición y los colores», e inicia la mejora. El campo admite hasta 2000 caracteres. La imagen y la instrucción se envían al proveedor de IA.

La operación requiere que la conexión original esté activa, que haya un modelo disponible y que el resultado contenga una sola imagen. En la aplicación, cada mejora posterior parte de la última revisión completada. En la versión actual del plugin de WordPress, la mejora desde la tarjeta del historial utiliza la imagen original. Las capas independientes de texto y vectores no forman parte del mapa de bits modificado.

La mejora con IA puede cambiar el aspecto y generar otro cargo. Revisa el nuevo resultado y después selecciónalo para el proyecto. Un cambio visual no sustituye automáticamente la imagen ya colocada en la escena.

Usa Seleccionar en la tarjeta del resultado. La ventana del generador se cerrará y podrás indicar una posición en el área de impresión. También puedes arrastrar la miniatura o la vista previa a la escena. Necesitas un proyecto abierto y un área de impresión preparada.

El conjunto se añade al proyecto como un grupo de capas. Puedes seguir editando el texto, los vectores simples y el código QR; la ilustración generada permanece como imagen. Ajusta la posición y la escala en 2D y comprueba la ubicación de la impresión sobre el modelo 3D.

Tras añadir la imagen, puedes utilizar las herramientas existentes: eliminación del fondo, máscaras, filtros, semitonos, vectorización y repetición de patrones. Esta etapa de edición en Designer está disponible con independencia de la generación.

Cuando termines los ajustes, guarda el proyecto con el botón habitual de Designer. Para reutilizar la composición, elige Guardar como nueva plantilla (biblioteca) en el cuadro de guardado correspondiente. Usa el historial de generación para elegir resultados y la biblioteca para conservar recursos reutilizables.

En WordPress, utiliza el proyecto o la plantilla guardados en los productos locales de tu tienda. El cliente puede personalizar la composición compartida en Customizer con los elementos preparados previamente. Generar una imagen no la publica automáticamente en la biblioteca ni en la oferta de la tienda.

Ve a Alter Product → Ajustes → Integración de IA y selecciona Añadir proveedor. Elige OpenAI, Google Gemini o Anthropic Claude. En Detalles de la conexión, selecciona los modelos que quieras utilizar.

Una conexión directa guarda una clave independiente en el plugin, cifrada con las claves de la instalación de WordPress. También puedes usar WordPress AI Client y un conector compartido configurado en Ajustes → Connectors. Esta opción requiere WordPress 7.0 o posterior y un conector disponible para el proveedor.

Guarda la conexión, define los límites, marca Activar IA con mis cuentas de proveedores y haz clic en Guardar ajustes de IA. En la ventana que se abre, lee la información sobre costes, procesamiento de contenido y revisión de resultados, marca tu aceptación y confirma el guardado. Añadir una conexión por sí solo no activa la generación.

En OpenAI y Gemini, la conexión de imágenes también incluye un modelo de texto para preparar la composición. Elige ambos modelos en los detalles. Claude permite trabajar con texto; para usarlo en el generador local, desactiva Imagen y selecciona las capas de texto, vectores simples o QR que necesites.

En el plugin, la calidad de imagen de OpenAI está limitada a Low de forma predeterminada y se puede cambiar en los límites de uso. La integración de Gemini utiliza una resolución de 1K; ese límite de calidad de OpenAI no se aplica a Gemini. Los ajustes y la preparación de la composición difieren del servicio de la aplicación, por lo que el mismo prompt no implica un resultado idéntico en ambos entornos.

Abre un proyecto de producto local mediante Product Designer en el plugin o la acción de Designer del producto WooCommerce. Inicia allí el Generador de IA, prepara un resultado y añádelo al proyecto siguiendo el proceso descrito antes.

La generación requiere un administrador con permiso para gestionar los ajustes de WordPress. Las interfaces públicas Customizer, Configurator y Viewer no generan contenido con IA usando la clave de la tienda. Sí pueden mostrar y utilizar imágenes guardadas previamente en productos preparados.

Al guardar un proyecto o una plantilla, las imágenes necesarias se copian a los recursos locales de WordPress. Eliminar una entrada del historial de IA no borra los archivos independientes ya guardados en el proyecto. Las plantillas se siguen gestionando en Assets; no se trata de un generador de IA independiente en la pestaña de recursos.

La generación, la nueva generación y la mejora de detalles con IA utilizan la API del proveedor. Una acción en la interfaz puede incluir varias solicitudes, como preparar la composición y generar la imagen. La vista previa, la inserción de un resultado guardado y la ampliación estándar no inician una nueva generación en el proveedor.

El límite diario predeterminado del plugin es de 20 intentos de solicitud, compartidos entre los administradores del sitio. En un conjunto habitual con imagen, la planificación y la imagen suelen consumir dos intentos; solo texto consume uno. Los intentos fallidos también pueden contar. El contador se reinicia a medianoche UTC.

El límite de intentos no es un presupuesto económico. Configura también los límites de gasto disponibles en tu cuenta del proveedor y revisa la facturación. Cancelar una tarea no revierte el cargo de una llamada ya realizada. En la aplicación se aplican límites del servicio y del proveedor; no son el mismo contador que el límite del plugin.

Conserva los materiales terminados en proyectos o plantillas, en lugar de depender solo del historial de IA. Antes de enviarlos a producción, comprueba el texto, la nitidez, la transparencia, el tamaño y la lectura del código QR. Después continúa con las áreas de impresión y el Gestor de impresión.

En el plugin, la conexión directa y el conector compartido de WordPress tienen ajustes de claves independientes. Cambiar el método de conexión no transfiere automáticamente el secreto entre ellos. Las claves directas y el historial privado de IA están vinculados a las claves de cifrado de la instalación, así que consérvalas junto con una copia segura de la base de datos y los archivos de WordPress.