Hermes

Conecta Hermes Agent a YouThumb para configurar tu persona una sola vez y luego generar variaciones de miniatura con una simple solicitud. La skill explica los endpoints disponibles, las reglas de créditos y los límites de lo que puede hacer el agente.

Instala la skill para Hermes Agent

Desde el espacio de trabajo donde usas Hermes, ejecuta:
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-api
Elige Hermes Agent cuando se te pida. Para seleccionarlo de forma explícita:
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-api --agent hermes-agent
Su identificador explícito de agente es hermes-agent. Instala la skill donde tu entorno de Hermes pueda acceder a ella, abre una nueva sesión y pídele que use youthumb-api.

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 del agente:
bash
export YOUTHUMB_API_KEY="your-api-key"
Instalar una skill no configura las credenciales. Mantén la clave fuera de los archivos versionados y asegúrate de que Hermes pueda llegar a https://www.youthumb.ai por HTTPS.

Configura tu persona

text
Usa la skill youthumb-api. Crea una persona llamada "Mike" y añade las
tres fotos del rostro de ./faces, una solicitud a la vez.
Fotos claras, bien iluminadas y desde varios ángulos dan los mejores resultados. Solo lo haces una vez; después, la persona también está disponible en la app.

Genera variaciones

text
Crea una miniatura con mi persona "Mike", el preset free, el título
"BUILD IT" y 3 variaciones. Muéstrame el proyecto antes de iniciar.
Cuando confirmas, Hermes inicia la generación, espera a que termine y te devuelve las URL de las tres imágenes. Abre el proyecto en YouThumb para comparar las variaciones lado a lado y quedarte con la mejor.

Recupérate de los errores

Si una solicitud agota el tiempo de espera al crear un proyecto, pide a Hermes que revise los proyectos existentes antes de volver a intentarlo, para no crear un duplicado. Para los detalles de los endpoints, consulta la API para desarrolladores.

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.