youthumb-api 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 |
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-apiGé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-api. 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’à cinq images de référence, 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 n’expose pas toutes les fonctionnalités de l’application. Le croquis de composition, l’amélioration du prompt, la comparaison, les favoris et la corbeille s’utilisent dans l’app.
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.