openclip-thumbnails

OpenClip : vignettes et édition d'images

Deux outils gratuits, généralement utilisés ensemble :

• extract_thumbnails – extraire des images fixes d'une vidéo.
• edit_image – compresser, redimensionner, recadrer ou reformater une image.

Les deux sont GRATUITS, nécessitent un compte OpenClip mais aucun abonnement ni crédit.

Configuration (une fois)

OpenClip est un serveur MCP distant situé à https://openclip.app/mcp. Connectez-vous avec votre compte OpenClip lorsque la fenêtre OAuth apparaît ; aucune clé API à copier.

• Claude Code : claude mcp add --transport http openclip https://openclip.app/mcp, puis /mcp pour autoriser.
• Claude Desktop / web : Paramètres, Connecteurs, "Ajouter un connecteur personnalisé", collez l'URL, connectez-vous.
• Cursor (.cursor/mcp.json) : { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clients avec en-têtes uniquement : générez un token MCP sur openclip.app/settings/connect et connectez-vous à https://openclip.app/mcp/key avec Authorization: Bearer <token>.

Vérification : appelez get_account.

Transférer le fichier

1. create_upload(filename, content_type) renvoie un id et une upload_url.
2. Envoyez les octets bruts en PUT vers upload_url.
3. Passez l'id renvoyé comme argument video (vignettes) ou file (édition d'image).

N'appelez PAS complete_upload. Cela déclencherait le pipeline de clipping payant. Les outils gratuits lisent directement le fichier téléversé. Les vidéos déjà présentes dans list_videos peuvent également servir d'entrée.

extract_thumbnails

extract_thumbnails(video, count?, width?).

• count – de 1 à 10, par défaut 1. Les images sont réparties sur toute la durée de la vidéo, donc count: 5 donne une sorte de planche contact pour choisir.
• width – largeur en pixels optionnelle pour les images de sortie.

Le résultat est un zip d'images, pas des URLs individuelles. Donnez l'URL du zip à l'utilisateur, ou décompressez-le si vous avez besoin d'une image spécifique.

Lorsque l'utilisateur souhaite une image à un instant précis plutôt qu'une répartition uniforme, rognez d'abord la vidéo à ce moment avec edit_video (operation="trim", voir openclip-video-editing), puis extrayez une seule vignette du clip rogné.

edit_image

edit_image(file, operation, ...params), une seule opération par appel :

• compress – quality de 1 à 100 (par défaut 80), format optionnel (jpg, png, webp).
• resize – width et height en pixels, format optionnel.
• crop – soit aspect ("1:1", "9:16", "16:9", "4:5") soit x, y, width, height explicites, format optionnel.

Utilisez webp lorsque l'image va sur une page web et jpg quand elle doit fonctionner partout.

Interrogation (polling)

Les deux outils renvoient un hashid tool_job avec status: "queued". Interrogez get_tool_job_status(tool_job) toutes les 5 à 10 secondes :

• queued / processing – en cours, continuez à interroger.
• completed – renvoie les URLs CDN permanentes outputs ainsi que result_meta.
• failed – renvoie error.

Règles

• Toujours interroger (polling) ; les deux outils sont asynchrones.
• Une seule opération edit_image par appel. Pour redimensionner puis compresser, exécutez deux appels en séquence.
• extract_thumbnails renvoie toujours un zip. Ne promettez pas d'URLs d'images individuelles.
• Les URLs de sortie sont des liens CDN permanents, non signés et sans expiration.
• L'utilisation gratuite est limitée en débit par jour avec un plafond de taille par fichier.

Exemples de demandes en actions

• "Récupère une vignette de cette vidéo" – create_upload, PUT des octets, extract_thumbnails(video), interroger, renvoyer l'URL du zip.
• "Donne-moi 5 images pour choisir" – extract_thumbnails(video, count=5), interroger.
• "Je veux l'image à 1:30" – edit_video(video, operation="trim", start_ms=90000, end_ms=91000), interroger, puis extract_thumbnails sur le résultat, interroger.
• "Transforme cette image en carré webp" – edit_image(file, operation="crop", aspect="1:1", format="webp"), interroger.
• "Ce PNG est énorme, réduis-le" – edit_image(file, operation="compress", quality=75, format="webp"), interroger.

Connexes

Découper le sujet en PNG transparent se fait avec openclip-remove-background. Le rognage et le découpage de vidéo se font avec openclip-video-editing.