Codex

Conecta Codex a YouThumb para preparar miniaturas desde el espacio de trabajo de tu agente: sube logos y capturas de pantalla, escribe el prompt, lanza la generación y recupera los resultados. La skill aporta el contrato de la API y las reglas que mantienen tus créditos bajo control.

Instala la skill para Codex

Ejecuta el instalador desde el espacio de trabajo que usas con Codex:
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-api
Elige Codex cuando se te pida. Para seleccionarlo de forma explícita:
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-api --agent codex
Abre una nueva sesión de Codex en ese espacio de trabajo y pídele que use la skill youthumb-api. La skill describe la integración; tu entorno de ejecución sigue necesitando acceso a la red y una clave API de YouThumb.

Conecta tu cuenta de YouThumb

En YouThumb, abre Cuenta → Claves API y crea una clave. Ponla a disposición como YOUTHUMB_API_KEY en el entorno de ejecución de Codex:
bash
export YOUTHUMB_API_KEY="your-api-key"
La clave es de YouThumb, no una clave API de OpenAI. Mantenla fuera de los archivos versionados. Un entorno de agente alojado necesita su propia configuración de secretos; no hereda las variables de tu shell local.

Prepara tus recursos

text
Usa la skill youthumb-api. Comprueba que ./assets/logo.png y
./assets/screenshot.png son imágenes PNG reales, súbelas como recursos
y dame sus URL. No crees un proyecto todavía.
La skill le pide al agente que verifique cada archivo antes de subirlo: una página HTML guardada como .png fallaría.

Crea el proyecto y luego genera

text
Crea un proyecto de miniatura con el preset free: yo a la izquierda,
@image1 (logo) a la derecha con un brillo suave, @image2 (captura)
en el fondo. Título "SHIP IT". 2 variaciones.
Muéstrame el estado detallado antes de iniciar.
Codex comprueba que las dos referencias estén adjuntas y luego inicia la generación cuando confirmas. Cada variación consume créditos, así que empieza con poco.

Recupera los resultados

Pide a Codex que consulte el estado hasta que esté completado y que luego descargue las imágenes en la carpeta de tu proyecto. Consultar demasiado rápido activa el límite de solicitudes: una solicitud a la vez, con una pausa entre llamadas.

Solución de problemas

  • Skill no encontrada: revisa el alcance de la instalación y abre una nueva sesión donde se instaló la skill.
  • 401: revisa la clave y si fue revocada. La API tiene un límite de solicitudes estricto, así que un 401 justo después de muchas llamadas también puede significar que el agente debe esperar antes de volver a intentarlo.
  • 402: tus créditos no alcanzan para la generación.
  • 429: demasiadas llamadas; pide al agente que espere entre 30 y 45 segundos en lugar de reintentar en bucle.
Consulta Agentes y la API para desarrolladores.