youthumb-ai apprend à l’agent à utiliser l’API YouThumb : importer un logo, configurer une personne, créer un projet de miniature, lancer la génération et récupérer le résultat.
Ton agent travaille avec le même compte que l’application. Il utilise tes crédits, et les projets qu’il crée sont ceux que tu vois dans YouThumb.
Choisis ton agent
| Agent | Guide d’installation | Exemple d’usage |
|---|---|---|
| Claude Code | Connecter Claude Code à YouThumb | Générer une miniature pour la vidéo que tu es en train d’écrire |
| Codex | Connecter Codex à YouThumb | Importer tes logos et captures d’écran, puis les référencer |
| OpenClaw | Connecter OpenClaw à YouThumb | Préparer une miniature par vidéo dans un lot hebdomadaire |
| Hermes | Connecter Hermes à YouThumb | Configurer ta personne et générer des variations à comparer |
| MCP | Connecter YouThumb en MCP | Te connecter depuis Claude ou ChatGPT, sans clé API |
Installe le skill YouThumb
Lance cette commande dans ton terminal, depuis l’espace de travail que tu utilises avec ton agent. Il te faut Node.js et npm pour lancernpx.
bash
npx skills add https://github.com/mikecodeur/skills --skill youthumb-aiGénère une clé API
- Connecte-toi à YouThumb et ouvre Compte → Clés API.
- Crée une clé.
- Range-la en lieu sûr et rends-la disponible pour l’agent sous le nom
YOUTHUMB_API_KEY.
bash
export YOUTHUMB_API_KEY="your-api-key"https://www.youthumb.ai et envoie la clé dans l’en-tête x-api-key. Garde la clé hors de ton dépôt de code et des prompts partagés. C’est une clé YouThumb, distincte de tes identifiants Claude ou OpenAI.
Commence par une demande qui lit sans générer :
text
Utilise le skill youthumb-ai. Liste mes personnes et les presets disponibles.
Ne crée et ne génère rien pour l’instant.Ce que ton agent peut faire
- Assets : importer des images comme des logos, des captures d’écran ou des photos de produit, les lister et les supprimer.
- Personnes : créer une personne et ajouter des photos de visage, puis la réutiliser dans tes miniatures.
- Projets de miniature : créer un projet avec un prompt, une personne, un titre et jusqu’à six images de contenu, référencées dans le prompt par
@image1,@image2… - Génération : lancer une génération de 1 à 4 variations, suivre son statut et télécharger les images obtenues.
- Données de référence : lister les templates et presets disponibles.
L’API et le MCP exposent l’aide au prompt, les favoris et la corbeille. La création de croquis, la comparaison visuelle, Add Light et Add Title avec styles restent dans l’application.
Garde la main sur tes crédits
Créer un projet ne consomme pas de crédits ; lancer la génération, si. Demande à ton agent de te montrer le projet avant de le lancer, et de commencer avec une seule variation. Une réponse402 signifie que tes crédits sont insuffisants.
L’API a une limite de débit. Demande à l’agent d’attendre entre les appels et de ne pas réessayer en boucle. Tu peux révoquer la clé depuis Compte → Clés API quand l’intégration ne sert plus. Consulte l’API développeur pour les endpoints et les codes d’erreur.
L’API et le MCP permettent aussi recherche de projets, favoris, corbeille/restauration, résultats terminés, itération depuis un résultat, relance d’échec, aide payante au prompt et gestion des personnes/ressources. Voir les contrats MCP et les assets. Utilisez le skill canonique youthumb-ai : les anciennes copies youthumb-api / youthumb-prompts ne décrivent pas ces contrats.