youthumb-api le enseña al agente a usar la API de YouThumb: subir un logo, configurar una persona, crear un proyecto de miniatura, lanzar la generación y recuperar el resultado.
Tu agente trabaja con la misma cuenta que la aplicación. Usa tus créditos, y los proyectos que crea son los que ves en YouThumb.
Elige tu agente
| Agente | Guía de configuración | Ejemplo de flujo |
|---|---|---|
| Claude Code | Conectar Claude Code a YouThumb | Generar una miniatura para el video que estás guionizando |
| Codex | Conectar Codex a YouThumb | Subir tus logos y capturas de pantalla, y luego referenciarlos |
| OpenClaw | Conectar OpenClaw a YouThumb | Preparar una miniatura por video en un lote semanal |
| Hermes | Conectar Hermes a YouThumb | Configurar tu persona y generar variaciones para comparar |
Instala la skill de YouThumb
Ejecuta este comando en tu terminal desde el espacio de trabajo que usas con tu agente. Necesitas Node.js y npm disponibles para ejecutarnpx.
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-apiGenera una clave API
- Inicia sesión en YouThumb y abre Cuenta → Claves API.
- Crea una clave.
- Guárdala de forma segura y ponla a disposición del agente como
YOUTHUMB_API_KEY.
bash
export YOUTHUMB_API_KEY="your-api-key"https://www.youthumb.ai y envía la clave en el encabezado x-api-key. Mantén la clave fuera del control de versiones y de los prompts compartidos. Es una clave de YouThumb, distinta de tus credenciales de Claude u OpenAI.
Empieza con una solicitud que lee sin generar:
text
Usa la skill youthumb-api. Lista mis personas y los presets disponibles.
No crees ni generes nada todavía.Lo que puede hacer tu agente
- Recursos: subir imágenes como logos, capturas de pantalla o fotos de producto, listarlas y eliminarlas.
- Personas: crear una persona y añadirle fotos del rostro, y luego reutilizarla en tus miniaturas.
- Proyectos de miniatura: crear un proyecto con un prompt, una persona, un título y hasta cinco imágenes de referencia, referenciadas en el prompt como
@image1,@image2… - Generación: iniciar una generación de 1 a 4 variaciones, seguir su estado y descargar las imágenes resultantes.
- Datos de referencia: listar las plantillas y los presets disponibles.
La API no expone todas las funciones de la aplicación. El boceto de composición, la mejora del prompt, la comparación, los favoritos y la papelera se usan en la app.
Mantén el control de los créditos
Crear un proyecto no consume créditos; iniciar la generación sí. Pide a tu agente que te muestre el proyecto antes de lanzarlo y que empiece con una variación. Una respuesta402 significa que tus créditos no alcanzan.
La API tiene límite de solicitudes. Pide al agente que espere entre llamadas y que no reintente en bucle. Puedes revocar la clave desde Cuenta → Claves API cuando ya no necesites la integración. Consulta la API para desarrolladores para los endpoints y los códigos de error.