openclip-convert

OpenClip: conversión de medios

convert_media cambia el contenedor o códec de un archivo, incluyendo video a gif y video a solo audio. Es GRATUITO, necesita una cuenta de OpenClip pero no requiere suscripción ni créditos.

Configuración (una vez)

OpenClip es un servidor MCP remoto en https://openclip.app/mcp. Inicia sesión con tu cuenta de OpenClip cuando aparezca la solicitud OAuth, no hay una clave API que copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, luego /mcp para autorizar.
• Claude Desktop / web: Configuración, Conectores, "Añadir conector personalizado", pega la URL, inicia sesión.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes solo con cabecera: genera un token MCP en openclip.app/settings/connect y conéctate a https://openclip.app/mcp/key con Authorization: Bearer <token>.

Prueba de funcionamiento: llama a get_account.

Obteniendo el archivo

1. create_upload(filename, content_type) devuelve un id y una upload_url.
2. Haz un PUT de los bytes crudos a upload_url.
3. Pasa el id devuelto como argumento file.

NO llames a complete_upload. Eso inicia el pipeline de recorte de pago. Las herramientas gratuitas leen el archivo subido directamente. Un archivo que ya esté en list_videos también funciona como entrada.

Destinos

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

• Contenedores de video - mp4, webm, mov, mkv. Por defecto mp4 cuando el usuario solo quiere algo que se reproduzca en todas partes.
• gif - fps opcional (por defecto 12) y width (por defecto 480). Aumenta fps para movimiento más suave, aumenta width para un gif más nítido, ambos hacen que el archivo sea mucho más grande. Recorta primero la fuente si es larga, los gifs crecen rápidamente.
• Audio - mp3, aac, wav, flac. Úsalo para extraer audio de un video. mp3 para compartir, wav o flac cuando el audio se alimenta de otra herramienta que requiere sin pérdida.

Para alcanzar un tamaño de archivo específico en lugar de cambiar el formato, usa edit_video con operation="compress" (target_mb o crf), consulta la habilidad openclip-video-editing.

Sondeo

convert_media devuelve un tool_job hashid con status: "queued". Sondea get_tool_job_status(tool_job) cada 5 a 10 segundos:

• queued / processing - todavía en proceso, sigue sondeando.
• completed - devuelve URLs CDN permanentes outputs más result_meta.
• failed - devuelve error.

Nunca asumas que una llamada terminó de forma síncrona.

Reglas

• Siempre sondea, la conversión es asíncrona.
• Las URLs de salida son enlaces CDN permanentes, no firmados ni con caducidad.
• El uso gratuito tiene límite de velocidad por día con un límite de tamaño por archivo. El texto de error explica cómo levantar un límite.
• Convertir un video largo a gif produce un archivo enorme. Recorta primero los segundos interesantes y luego convierte.

Ejemplos de indicaciones a acciones

• "Convierte esto a mp4" - create_upload, PUT bytes, convert_media(file, to="mp4"), sondea.
• "Haz un gif de esto" - recorta primero el momento con edit_video, luego convert_media(file, to="gif", fps=15, width=640), sondea.
• "Dame solo el audio" - convert_media(file, to="mp3"), sondea.
• "Necesito audio sin pérdida para editar" - convert_media(file, to="wav"), sondea.

Relacionado

El recorte, el corte y la compresión orientada a tamaño están en openclip-video-editing. La transcripción del audio que acabas de extraer está en openclip-transcription.