openclip-convert

OpenClip : conversion de médias

convert_media change le conteneur ou le codec d'un fichier, y compris vidéo vers gif et vidéo vers audio uniquement. C'est GRATUIT, nécessite un compte OpenClip mais pas d'abonnement ni de crédits.

Configuration (une fois)

OpenClip est un serveur MCP distant à l'adresse https://openclip.app/mcp. Connectez-vous avec votre compte OpenClip lorsque la fenêtre OAuth apparaît, il n'y a pas de 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 sans en-tête : générez un jeton MCP sur openclip.app/settings/connect et connectez-vous à https://openclip.app/mcp/key avec Authorization: Bearer <token>.

Test de base : appelez get_account.

Transférer le fichier

1. create_upload(filename, content_type) renvoie un id et une upload_url.
2. PUT les octets bruts vers upload_url.
3. Passez l'id retourné comme argument file.

N'appelez PAS complete_upload. Cela déclenche le pipeline de clipping payant. Les outils gratuits lisent directement le fichier téléversé. Un fichier déjà présent dans list_videos peut également être utilisé en entrée.

Cibles

convert_media(file, to, ...params).

• Conteneurs vidéo – mp4, webm, mov, mkv. Par défaut mp4 lorsque l'utilisateur veut juste quelque chose qui se lit partout.
• gif – fps optionnel (défaut 12) et width (défaut 480). Augmentez fps pour un mouvement plus fluide, augmentez width pour un gif plus net, les deux augmentent considérablement la taille du fichier. Coupez d'abord la source si elle est longue, les gifs gonflent rapidement.
• Audio – mp3, aac, wav, flac. Utilisez ceci pour extraire l'audio d'une vidéo. mp3 pour le partage, wav ou flac lorsque l'audio alimente un autre outil qui nécessite du sans perte.

Pour viser une taille de fichier plutôt que de changer de format, utilisez edit_video avec operation="compress" (target_mb ou crf), voir la compétence openclip-video-editing.

Interrogation

convert_media renvoie un tool_job sous forme de hashid avec status: "queued". Interrogez get_tool_job_status(tool_job) toutes les 5 à 10 secondes :

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

Ne supposez jamais qu'un appel se termine de façon synchrone.

Règles

• Interrogez toujours, la conversion est asynchrone.
• Les URLs de sortie sont des liens CDN permanents, ni signés ni à expiration.
• L'utilisation gratuite est limitée en débit par jour avec un plafond de taille par fichier. Le texte d'erreur explique comment lever une limite.
• Convertir une vidéo longue en gif produit un fichier énorme. Coupez d'abord aux quelques secondes intéressantes, puis convertissez.

Exemples de prompts en actions

• "Convertis ceci en mp4" – create_upload, PUT des octets, convert_media(file, to="mp4"), interrogez.
• "Fais un gif de ceci" – coupez d'abord au moment voulu avec edit_video, puis convert_media(file, to="gif", fps=15, width=640), interrogez.
• "Donne-moi juste l'audio" – convert_media(file, to="mp3"), interrogez.
• "J'ai besoin d'audio sans perte pour le montage" – convert_media(file, to="wav"), interrogez.

Rubriques connexes

Le rognage, le recadrage et la compression ciblée sur la taille se trouvent dans openclip-video-editing. La transcription de l'audio que vous venez d'extraire est openclip-transcription.