Trabajos de imagen con Codex
Ejecute cada proyecto o lote de imágenes a través del ejecutor. No llame a codex exec o codex-imagegen manualmente para estos trabajos.
python scripts/codex_image.py "<prompt o @prompt.txt>" out.png [--ref room.jpg] [--size 1536x1024] [--force]
Imprime la ruta de salida absoluta. Asigne al comando Bash un tiempo de espera superior al --timeout propio del ejecutor (420 s por defecto).
| Salida | Significado | Acción |
|---|---|---|
| 0 | Guardado | Vea la imagen |
| 1 | Uso, por ejemplo, la salida existe | Corrija la llamada; --force reemplaza una salida, nunca su propia referencia |
| 2 | Codex terminó sin imagen | Lea la salida impresa, corrija la causa y reintente una vez |
| 3 | La llamada de imagen omitió la referencia, por lo que no se guardó nada | Reintente una vez con el mismo comando |
| 124 | Sin sesión o sin imagen a tiempo | Verifique codex login status y la red |
Reglas
- Revise cada salida contra su indicación. La salida 0 prueba que una imagen provino de esta sesión, no que sea correcta.
- Encadene las ediciones de a un cambio por vez: cada salida se convierte en el siguiente
--ref. Escriba en un archivo nuevo en cada paso. - Mantenga la habitación: indique lo que no debe cambiar (cámara, geometría, aberturas) y nombre el rol de cada referencia cuando haya dos o más. Hasta 4 referencias.
- Controle la cuota. Una ejecución gasta una imagen, y las ejecuciones pueden ir en paralelo, pero indique el conteo antes de un lote grande y asegúrese de que la primera imagen funcione antes que el resto.
- Referencias PNG con alfa: use
--keep-png-refs, porque la conversión a JPG las aplana.
Por qué existe el ejecutor
Medido con codex-cli 0.164.0 el 2026-11-04, a partir de los registros de sesión de 30 ejecuciones de imágenes.
| Falla | Causa | Lo que hace el ejecutor |
|---|---|---|
| Se cuelga hasta el tiempo de espera | codex exec espera una tubería de stdin abierta: 45 s con tubería (detenida por tiempo de espera), 4 s con ella cerrada | Envía el prompt por stdin y luego lo cierra |
| Imagen incorrecta bajo un nombre | Al pedirle que guardara, Codex buscó en la carpeta compartida ~/.codex/generated_images, tomó la más reciente y copió la imagen de otra ejecución | Codex nunca guarda; el ejecutor lee solo generated_images/<su id de sesión>/ |
| Hasta 7 llamadas de imagen para una salida | Codex no pudo encontrar cómo guardar, así que generó de nuevo | Detiene a Codex en la primera imagen completa |
| Referencia ignorada, habitación inventada | La herramienta de imagen ve los archivos adjuntos solo si la llamada establece num_last_images_to_include | Nombra el parámetro, lee el registro de sesión, sale con 3 si se omitió |
| Habitación perdida en pases encadenados | Cada pase de mobiliario que alimentó un PNG lo perdió; JPG con el parámetro nombrado lo mantuvo (correlación, no causa probada) | Convierte referencias PNG a JPG cuando ffmpeg está en PATH |
Verificado con el CLI real el mismo día: tres ediciones, dos de ellas en paralelo sobre una referencia PNG, cada una tomó aproximadamente 25 s y una llamada de imagen, y cada una mantuvo su propio cambio de color.
Si debe usar codex-imagegen del plugin
codex-bridge 1.2.0 tiene estas fallas. Llámelo con </dev/null, un trabajo a la vez, una referencia JPG y "llame a la herramienta de imagen exactamente una vez con num_last_images_to_include:1" en el prompt, luego vea el resultado.