Skip to Content
ModelosGPT ImageUsar sus propias herramientasObtener una clave

Generar imágenes en sus propias herramientas

No necesita escribir código. Conecte GPT Image a una herramienta que ya utilice y podrá generar imágenes directamente en ella.

Paso 1: obtener una clave

Qué hace este paso: una clave funciona como la contraseña de su cuenta. Su herramienta la utiliza para llamar a OfoxAI.

  1. Abra la consola de OfoxAI , vaya a Settings → API Keys y haga clic en Create New Key.
  2. Cópiela de inmediato y guárdela en un lugar seguro. La clave solo se muestra una vez, al crearla. Una vez cerrado el cuadro de diálogo, no podrá volver a verla.

Cree una clave exclusiva para esta herramienta. Si deja de utilizarla o sospecha que se ha filtrado, elimine esa clave concreta; nada más se verá afectado.

Coste aproximado: la facturación depende de la calidad. A los precios de referencia oficiales de OpenAI, una imagen de 1024×1024 cuesta menos de 1 céntimo con la calidad más baja, y unos 21 céntimos con gpt-image-2 en calidad alta. Pruebe primero con la calidad más baja y suba de nivel cuando esté satisfecho. Consulte Calidad y precio.

Introduzca la clave únicamente en los ajustes de su herramienta o en el archivo que le indique su agente de programación. No la envíe en un chat ni comparta capturas de pantalla en las que aparezca.

Siguiente: determine qué tipo de herramienta tiene.

Paso 2: determinar qué tipo de herramienta tiene

Qué hace este paso: cada herramienta se conecta de una forma distinta, así que primero identifique a qué tipo pertenece la suya.

Su herramientaEjemplosCómo conectarla
Cliente de chat o de imagen: tiene interfaz gráfica y permite añadir su propio proveedor de modelosCherry Studio, LobeHub, etc.Completar unos pocos ajustes
Asistente de IA / agente de programación: conversa con él para escribir código o manejar su ordenadorClaude Code, Codex, ZCode, OpenClaw, WorkBuddy, etc.Copiar una instrucción y enviarla

Herramientas habituales (comprobado el 2026-09-30):

HerramientaCómo conectarla
Cherry StudioClientes de chat e imagen. Al añadir el modelo, establezca “Tipo de punto final” en “Generación de Imágenes (OpenAI)”; de lo contrario, el modelo no aparecerá en “Pinturas”. Para añadir el proveedor, consulte Configuración de Cherry Studio
LobeHubClientes de chat e imagen, pero utilizando su proveedor integrado “OpenAI”. Los modelos que añade usted mismo en LobeHub no pueden configurarse con el tipo imagen, así que no cree un proveedor nuevo: en el proveedor OpenAI integrado, cambie “URL del proxy de la API” a https://api.ofox.io/v1, introduzca su clave y elija GPT Image 2 al generar imágenes. Los dos modelos 2.5 aún no figuran en su lista integrada
ChatboxAún no compatible. Su generación de imágenes solo funciona actualmente con el servicio propio de Chatbox y no puede utilizar un proveedor externo
WorkBuddyAsistentes de IA y agentes de programación. Sus ajustes de modelo solo aceptan modelos de chat. Primero conéctelo siguiendo la Configuración de WorkBuddy y, a continuación, envíele la instrucción siguiente
Claude Code, Codex, ZCode, OpenClawAsistentes de IA y agentes de programación. Envíele directamente la instrucción siguiente

¿Sigue sin estar seguro? Si los ajustes tienen una opción como “Añadir proveedor” o “API personalizada”, siga Clientes de chat e imagen. Si normalmente le pide que escriba código o realice tareas por usted, siga Asistentes de IA y agentes de programación.

Siguiente: vaya al método correspondiente.

Clientes de chat e imagen

Compruebe que su herramienta puede generar imágenes

Qué hace este paso: verifica que su herramienta puede utilizar un modelo de imagen externo. No todas las herramientas pueden.

Deben cumplirse estas dos condiciones:

  • La herramienta tiene un punto de acceso como “Pinturas”, “Generación de imágenes” o “Dibujar”.
  • En ese punto de acceso, puede elegir un proveedor y un modelo que haya añadido usted mismo.

Las funciones de dibujo de algunas herramientas solo funcionan con sus modelos integrados y no permiten elegir un proveedor añadido por usted. Esas herramientas no pueden utilizar GPT Image. Si no está seguro, consulte la documentación de la propia herramienta. Si su herramienta no cumple las condiciones, siga en su lugar Asistentes de IA y agentes de programación.

Añada OfoxAI como proveedor

Qué hace este paso: indica a la herramienta a dónde enviar las peticiones y qué clave utilizar.

¿Ya ha conectado modelos de chat de OfoxAI en esta herramienta? Utilice ese proveedor y pase al paso siguiente.

¿Todavía no? Siga la guía de configuración de la herramienta, que incluye capturas de pantalla de cada paso: Cherry Studio · LobeHub · Todas las herramientas. Los campos clave son:

Complete estos campos al añadir el proveedor
Tipo de proveedorOpenAISi no existe la opción OpenAI, elija "Compatible con OpenAI"
URL de la APIhttps://api.ofox.io/v1Algunas herramientas (como NextChat) la necesitan sin el /v1 final; siga la guía de configuración de esa herramienta
Clave de APIPegue la clave que copió en el paso 1

En LobeHub, no cree un proveedor nuevo. Los modelos que añade usted mismo en LobeHub no pueden configurarse con el tipo imagen, así que utilice en su lugar su proveedor integrado “OpenAI”:

LobeHub: complete estos campos en el proveedor OpenAI integrado
URL del proxy de la APIhttps://api.ofox.io/v1
Clave de APIPegue la clave que copió en el paso 1
Elija al generarGPT Image 2Los dos modelos 2.5 aún no figuran en la lista integrada de LobeHub

Añada un modelo de imagen

Qué hace este paso: indica a la herramienta qué modelo utilizar para las imágenes.

Añada manualmente un modelo a este proveedor y copie uno de estos ID de modelo:

Complete estos campos al añadir el modelo
ID de modeloopenai/gpt-image-2.5-flareGeneración de imágenes cotidiana, rápida; empiece por este
ID de modeloopenai/gpt-image-2.5-sunburstEdición, más fiel a la imagen original
Tipo de modeloGeneración de imágenesEn Cherry Studio corresponde a "Tipo de punto final" → "Generación de Imágenes (OpenAI)"; en otras herramientas, elija una opción de generación de imágenes, no de chat

Genere una imagen

Qué hace este paso: en el punto de acceso de imágenes, elija el modelo que acaba de añadir, introduzca una descripción y genere una imagen de prueba.

Si la herramienta permite elegir la calidad, empiece por la baja (low) y suba de nivel cuando compruebe que funciona. Una calidad mayor cuesta más y tarda más; las imágenes de alta calidad pueden tardar varios minutos.

¿No obtiene ninguna imagen? Consulte las preguntas frecuentes.

Asistentes de IA y agentes de programación

Si aún no ha instalado un agente de programación, siga primero una guía: Claude Code, Codex, OpenClaw.

Un agente de programación puede hacer por usted una de estas dos cosas. Elija la que necesite:

  • Generar imágenes para mí: usted describe la imagen en el chat, y el agente la genera y la guarda en su ordenador.
  • Añadirlo a mi proyecto: por ejemplo, está creando un sitio web o un miniprograma y desea que genere imágenes.

Envíe la instrucción a su agente de programación

Qué hace este paso: indica al agente de programación qué hacer y cómo hacerlo de forma segura. Primero le ayudará a guardar la clave y después se pondrá a trabajar.

Copie la instrucción que corresponda a su necesidad y envíela a Claude Code, Codex, ZCode, OpenClaw o WorkBuddy:

Generar imágenes para mí

Copie esta instrucción si desea generar imágenes conversando con el agente.

Quiero generar imágenes con los modelos GPT Image de OfoxAI. Ya he creado una clave de API en la consola de OfoxAI. No tengo muchos conocimientos técnicos, así que guíeme paso a paso. Antes de cada paso, explíqueme en lenguaje sencillo qué va a hacer y qué viene después.

[Paso 1: ayúdeme a guardar la clave de forma segura]
1. Cree un archivo .env en la carpeta actual que contenga una sola línea: OFOX_API_KEY= (deje el valor vacío). Si la carpeta actual es un repositorio de código, añada .env a .gitignore.
2. Indíqueme dónde está el archivo y cómo abrirlo, para que yo mismo pegue la clave después del signo = y lo guarde.
3. No me pida que envíe la clave en este chat. Si la pego por error, recuérdeme que elimine esa clave en la consola y cree una nueva.
4. Espere a que le diga "listo" antes de continuar.

[Paso 2: prepararse para generar imágenes]
5. Escriba un pequeño script que lea OFOX_API_KEY de .env y llame a POST https://api.ofox.io/v1/images/generations para generar una imagen.
6. Utilice el modelo openai/gpt-image-2.5-flare, calidad low, tamaño 1024x1024, y configure el tiempo de espera del cliente en 600 segundos.
7. El campo data[0].b64_json devuelto es base64 sin prefijo. Decodifíquelo y guárdelo como PNG en una carpeta images dentro de la carpeta actual.
8. No muestre la clave en pantalla ni la escriba en el script.

[Paso 3: probar con una imagen]
9. Genere primero "una manzana roja sobre una mesa blanca" y, a continuación, dígame dónde se ha guardado la imagen y cómo abrirla.
10. Después, cada vez que le describa una imagen, genérela con este script y dígame dónde se ha guardado. Si le digo "más calidad", cambie quality a medium o high y recuérdeme que cuesta más y tarda más.

[Si algo falla]
11. Muestre el estado HTTP y el error completo (incluidos error.message y request_id), busque la causa en https://ofox.io/es/docs/develop/models/gpt-image#errors y cambie solo una cosa antes de volver a intentarlo.
12. Si el mismo error persiste tras dos correcciones, deténgase, explíqueme el problema en lenguaje sencillo y facilíteme el request_id y el mensaje de error exacto para que pueda contactar con OfoxAI.
13. Genere una imagen cada vez y no reintente por lotes por su cuenta (cada petición se factura).

Añadirlo a mi proyecto

Copie esta instrucción si desea que su sitio web o aplicación genere imágenes.

Quiero añadir la generación de imágenes con GPT Image de OfoxAI a este proyecto. Ya he creado una clave de API en la consola de OfoxAI. No tengo muchos conocimientos técnicos, así que guíeme paso a paso. Antes de cada paso, explíqueme en lenguaje sencillo qué va a hacer y qué viene después.

[Paso 1: ayúdeme a guardar la clave de forma segura]
1. Cree un archivo .env en el proyecto que contenga una sola línea: OFOX_API_KEY= (deje el valor vacío).
2. Añada .env a .gitignore para que nunca se incluya en un commit ni se suba.
3. Indíqueme dónde está el archivo y cómo abrirlo, para que yo mismo pegue la clave después del signo = y lo guarde.
4. No me pida que envíe la clave en este chat. Si la pego por error, recuérdeme que elimine esa clave en la consola y cree una nueva.
5. Espere a que le diga "listo" antes de continuar.

[Paso 2: escribir el código]
6. Utilice el SDK oficial de OpenAI contra los endpoints de imágenes de OfoxAI con base_url https://api.ofox.io/v1, leyendo la clave de OFOX_API_KEY en .env.
 - Texto a imagen: POST /v1/images/generations
 - Edición, combinación de imágenes, inpainting: POST /v1/images/edits (subida multipart)
7. Utilice los ID de modelo completos: openai/gpt-image-2.5-flare (openai/gpt-image-2.5-sunburst para la edición).
8. Indique siempre quality explícitamente; utilice low durante el desarrollo. Si se omite, el modelo elige un nivel por sí mismo.
9. size debe cumplir todas estas condiciones: ancho y alto divisibles entre 16, lado mayor ≤ 3840, relación de aspecto entre 1:3 y 3:1, píxeles totales ≥ 655.360.
10. El resultado está en data[0].b64_json como base64 sin el prefijo data:; decodifíquelo y guárdelo como archivo de imagen.
11. Configure el tiempo de espera del cliente en 600 segundos.
12. No envíe response_format, input_fidelity ni style.
13. No escriba nunca la clave en el código, los registros ni los mensajes de error; oculte la cabecera Authorization al mostrar las peticiones.

[Paso 3: probar]
14. Realice una llamada real con quality=low y size=1024x1024, confirme que devuelve 200 y que la imagen se abre, y después dígame dónde se ha guardado la imagen.
15. Genere una imagen cada vez durante las pruebas; no escriba bucles que prueben por lotes (cada petición se factura).

[Si algo falla]
16. Muestre el estado HTTP y el cuerpo completo de la respuesta (incluidos error.message y request_id), y busque la causa en https://ofox.io/es/docs/develop/models/gpt-image#errors
17. Ante un 429, espere y reintente; ante otros errores, corrija primero la petición en lugar de reintentarla sin cambios.
18. Si el mismo error persiste tras dos correcciones, deténgase, explíqueme el problema en lenguaje sencillo y facilíteme el request_id y el mensaje de error exacto para que pueda contactar con OfoxAI.

[Comprobación previa a la puesta en producción]
19. Cuando le diga "listo para publicar", compruebe cada punto e indíqueme el resultado: ninguna clave en el código ni en el historial de commits; .env está en .gitignore; todas las peticiones indican quality; el tiempo de espera es ≥ 600 segundos; los errores muestran el código de estado, el texto de error original y el request_id.

Referencias:
- Valores y restricciones de esta familia: https://ofox.io/es/docs/develop/models/gpt-image
- Estructura común de los endpoints: https://ofox.io/es/docs/api/openai/images

Pegue la clave en el archivo cuando se lo pida

Qué hace este paso: mantiene la clave únicamente en un archivo de su ordenador, nunca en el chat.

El agente de programación le indicará dónde está el archivo .env. Ábralo, pegue su clave después de OFOX_API_KEY=, guárdelo y responda “listo”.

Observe cómo genera la primera imagen

Qué hace este paso: confirma que todo está conectado.

El agente de programación genera primero una imagen de prueba y le indica dónde se ha guardado. Si puede abrirla, ya está todo listo. A partir de ese momento, basta con indicarle en el chat qué imagen desea.

De qué le protegen estas dos instrucciones

RequisitoQué ocurre si no se cumple
Clave en .env, nunca enviada en el chatLa clave puede acabar en su código o subida a internet
ID de modelo copiado de la documentaciónUn uso incorrecto de mayúsculas devuelve 404
Calidad baja por defectoEl modelo elige un nivel; la calidad y el coste varían
Tiempo de espera de 600 segundosLa alta calidad puede tardar varios minutos; si se desconecta antes, la imagen se pierde, pero la petición se factura igualmente
Mostrar el error completoEl agente de programación solo ve “la petición ha fallado” y tiene que adivinar
Detenerse tras dos intentos fallidosEl agente de programación sigue reintentando y paga cada vez

Si algo sale mal

Qué hace este paso: permite que el agente de programación encuentre la causa y la corrija por sí mismo. Para la mayoría de los errores, puede resolver el problema en cuanto ve el texto real del error.

Cuando algo falle, envíele esto:

Instrucción de depuración

Envíela a su agente de programación cuando falle la generación de imágenes.

La última petición de imagen ha fallado. Depúrela en este orden y explíqueme el resultado en lenguaje sencillo:
1. Muestre el estado HTTP y el error completo de esa petición (oculte la cabecera Authorization).
2. Lea error.message y busque la causa en https://ofox.io/es/docs/develop/models/gpt-image#errors
3. Cambie solo una cosa y reintente una vez con quality=low y size=1024x1024.
4. Si sigue fallando, deténgase, dígame qué ha ido mal y facilíteme el request_id y el mensaje de error exacto.

¿Sigue sin resolverse? Contacte con OfoxAI indicando el request_id y el mensaje de error que le haya dado el agente de programación, para que podamos localizar esa petición concreta. No envíe nunca la clave.

Preguntas frecuentes

¿Puede mi herramienta generar imágenes con GPT Image?

Un cliente de chat o de imagen necesita dos cosas: un punto de acceso como "Pinturas" o "Generación de imágenes", y la posibilidad de elegir en él un proveedor y un modelo añadidos por usted. Algunas herramientas solo pueden dibujar con sus modelos integrados, y esas herramientas no se pueden conectar. Los agentes de programación como Claude Code, Codex, ZCode y OpenClaw funcionan todos: envíele a uno la instrucción de esta página y escribirá un pequeño script para generar imágenes por usted.

¿Cómo configuro GPT Image para Pinturas en Cherry Studio?

Añada en Cherry Studio un proveedor de tipo OpenAI con la dirección de API https://api.ofox.io/v1 y su clave. A continuación, añada manualmente el modelo openai/gpt-image-2.5-flare y establezca su Tipo de punto final en Generación de Imágenes (OpenAI) para que aparezca en Pinturas.

¿Puede LobeHub generar imágenes con GPT Image?

Sí, mediante su proveedor OpenAI integrado: cambie "URL del proxy de la API" a https://api.ofox.io/v1, introduzca su clave y elija GPT Image 2 al generar imágenes. Los modelos que añade usted mismo en LobeHub no pueden configurarse con el tipo imagen, así que no cree un proveedor nuevo. Los dos modelos GPT Image 2.5 aún no figuran en su lista integrada.

¿Qué hago si mi herramienta indica un fallo de conexión o un 404?

Compruebe tres cosas: que la URL de la API sea https://api.ofox.io/v1 (algunas herramientas, como NextChat, la necesitan sin /v1); que la clave se haya copiado completa y sin espacios adicionales; y que el ID de modelo se haya copiado exactamente de la documentación, con las mayúsculas y minúsculas correctas.

¿Cuánto cuesta una imagen y cuánto tarda?

La facturación depende de la calidad. A los precios de referencia oficiales de OpenAI, una imagen de 1024x1024 cuesta menos de 1 céntimo en low, y unos 21 céntimos con gpt-image-2 en high. La latencia varía según la calidad y el tamaño; la alta calidad puede tardar varios minutos. Lo que se le cobra realmente es el usage de cada petición; los precios vigentes de OfoxAI figuran en las páginas de los modelos. Empiece por low para confirmar que funciona y suba de nivel según sea necesario.

¿Qué hago si he enviado mi clave en un chat por error?

Elimine esa clave en la consola de OfoxAI, cree una nueva e introdúzcala en los ajustes de su herramienta o en el archivo .env como se ha descrito. Una vez eliminada, la clave anterior deja de funcionar.

Last updated on