youthumb-ai 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 |
| MCP | Conectar YouThumb por MCP | Iniciar sesión desde Claude o ChatGPT, sin clave API |
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-aiGenera 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-ai. 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 seis imágenes de contenido, 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 y MCP exponen asistencia al prompt, favoritos y papelera. Crear bocetos, comparación visual, Add Light y Add Title con estilos siguen siendo funciones de la aplicación.
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.
La API y MCP también permiten buscar proyectos, gestionar favoritos, papelera/restauración, resultados, iteración desde un resultado, reintentos fallidos, asistencia de pago al prompt y personas/recursos. Consulta contratos MCP y recursos. Usa el skill canónico youthumb-ai; las copias antiguas youthumb-api / youthumb-prompts no describen estos contratos.