Transloadit
Precios
  • Subida de archivos
  • Importación de archivos
  • Procesamiento por lotes
  • Encoding de video
  • Encoding de audio
  • Procesamiento de imágenes
  • Procesamiento de documentos
  • Inteligencia artificial
  • Filtrado y seguridad de archivos
  • Catalogación de medios
  • Compresión de archivos
  • Evaluación de código
  • Exportación de archivos
  • Smart CDN
  • Ver todos los servicios
  • Explora integraciones
  • Explora demos en vivo (English)
  • Uppy
  • TransloaditKit
  • SDK para Android
  • SDK para Node.js
  • Viewer para Next.js
  • SDK para Python
  • SDK para Ruby
  • SDK para Go
  • SDK para Java
  • SDK para PHP
  • Zapier
  • Servidor MCP
  • Transloadit CLI
  • Terraform
  • Conceptos esenciales
  • Prácticas recomendadas
  • FAQ
  • Robots
  • Endpoints de la API
  • Formatos
  • Crea tu primera app
  • Acerca de Transloadit
  • Comparaciones
  • Código abierto
  • Testimonios
  • Empleos (English)
  • Seguridad
  • Entradas
  • Actualidad para desarrolladores (English)
  • Consejos para desarrolladores
  • Prensa
  • Investigación (English)
  • Casos de éxito
  • Soluciones
  • Guías
  • Glosario
  • Legal (English)
  • Herramientas
  • Cómo ayudamos a Coursera a llevar educación a millones de personas en todo el mundo
  • Soporte de Transloadit
  • Soporte para código abierto
  • Acuerdo de nivel de servicio (English)
  • Reserva una demo con nuestros ingenieros (English)
Conceptos esencialesRobotsFAQEndpoints de la APIFormatosPrácticas recomendadas
Primeros pasos
  • Descripción general
  • Mi primera aplicación
  • Guardar los archivos de resultados
Temas
  • Assembly Instructions
  • Assembly Variables
  • Evaluación dinámica
  • Templates
  • Webhooks
  • Credenciales de terceros
  • Builtin Templates
  • Estrategias de redimensionamiento
  • Assembly Execution Progress
  • Workspaces
  • Agentes de IA
  • Parámetro use avanzado
  • El parámetro ignore_errors
Kits de desarrollo de software
  • Resumen
  • SDK para Android
  • Navegadores
  • Convex
  • cURL
  • SDK de Go
  • SDK de Java
  • Servidor MCP
  • Formulario multipart
  • SDK de Node.js
  • Viewer para Next.js
  • SDK de PHP
  • SDK de Python
  • SDK de Ruby
  • Terraform
  • TransloaditKit
  • Integración con Zapier
Migración
  • Guías de migración
  • Migra de Cloudinary a Transloadit
  • Migrar de Uploadcare a Transloadit
  • Migra de Mux a Transloadit
  • Migra de Filestack a Transloadit

Agentes de IA

Los agentes de programación con IA, como Claude Code, OpenAI Codex y Cursor, pueden conectarse a Transloadit y usar 96 Robots actuales para subir archivos, aplicarles encoding y transformarlos. Los agentes pueden combinar el servidor MCP para acceder a herramientas en tiempo de ejecución, las Agent Skills reutilizables para flujos de trabajo dirigidos por personas y llms.txt para obtener contexto de documentación. La CLI ofrece una vía de automatización independiente para personas y CI.

Empieza desde tu proyecto

Pega este prompt en tu agente de programación desde la raíz del proyecto. Hace que el agente inspeccione tu stack antes de elegir un SDK, MCP o Skills, y mantiene el primer cambio fácil de revisar:

Set up the smallest safe Transloadit integration for this repository.

1. Inspect the project’s language, runtime, package manager, existing upload/media code, tests, and agent configuration before changing files.
2. Choose the narrowest integration that fits: an official SDK for application code, MCP for agent-executed runtime tools, the CLI (npx -y @transloadit/node) for scripts and CI jobs, and Agent Skills for repeatable workflow guidance. Reuse an existing integration when present.
3. Before editing, summarize what you found, which path you chose, and the files and commands you expect to change. Use the project’s existing package manager.
4. For interactive hosted MCP, add the hosted URL https://api2.transloadit.com/mcp to the client configuration without any token or key, and have the user approve browser OAuth. For CI or headless hosted MCP, mint an mcp-audience Bearer token at run time in a trusted environment, mint a new one when it expires, and supply it through secret storage or an environment variable.
5. Use TRANSLOADIT_KEY and TRANSLOADIT_SECRET only in a trusted server, CLI, CI, or self-hosted MCP process. When signing with an Auth Key, match its signature algorithm: for the Node CLI or self-hosted MCP, set TRANSLOADIT_SIGNATURE_ALGORITHM; in Node SDK code, pass the signatureAlgorithm option. Console keys with Smart CDN signing on (the default) use sha256; the Console’s snippet for the key shows the value.
6. Never expose TRANSLOADIT_SECRET to browser, mobile, or other client code. Give client code a public Auth Key and a Template ID; for production, generate the params and signature on a trusted backend with Signature Authentication. Use unsigned client params only with test credentials.
7. Never hardcode, print, commit, or overwrite credentials, including minted Bearer tokens. Keep secrets out of committed MCP configuration. If required credentials are unavailable, scaffold placeholders and stop before account operations.
8. Create one minimal, typed workflow and validate its Assembly Instructions. Prefer an existing small media fixture. Without an account, validate inline instructions locally with npx -y @transloadit/node assemblies lint --steps <file>. Linting against a Template ID needs credentials. Do not create an account, change a plan, or modify production Templates.
9. Run the repository’s checks. If authenticated Transloadit access (an approved hosted MCP connection or credentials in a trusted process) and a suitable fixture are available and the user has authorized a live test, run one Assembly, wait for completion, and report its Assembly ID, status, and result URL. Otherwise, report the exact command or MCP tool call the maintainer can run. Credentials or an approved connection alone do not authorize a live run.
10. Summarize every changed file, verification result, and any remaining manual step.

El resultado esperado es un pequeño cambio en el repositorio, no solo un ejemplo de código generado. Revisa el límite de credenciales que propone el agente antes de permitir que se ejecute una Assembly real.

Qué debería elegir el agente

Señal del proyectoPunto de partida
Aplicación en Node.js, Python, Ruby, PHP, Go, Java, Android o iOSEl SDK oficial correspondiente
El agente necesita aplicar lint a instrucciones, consultar la documentación o ejecutar AssembliesServidor MCP
Scripts de compilación, trabajos de CI, pipelines de shell o linting sin cuentaCLI
El equipo quiere un flujo de trabajo reutilizable y bajo control de versionesAgent Skills
Todavía no se necesita una integración en tiempo de ejecuciónllms.txt y páginas de documentación en Markdown

Servidor MCP

El Model Context Protocol⁠ (MCP) da a los agentes acceso directo en tiempo de ejecución a las herramientas de Transloadit.

Demostración: encoding de videos a streaming adaptativo HLS con el servidor MCP de Transloadit en Claude

Hay tres formas de conectarte. Elige la primera que se adapte a tu cliente:

ClienteForma de conexiónCredenciales
Cliente de agente interactivo, como Claude, ChatGPT, Codex o CursorURL alojadaAprueba OAuth en tu navegador
Trabajo de CI o entorno de ejecución de agentes sin interfazURL alojada con un token BearerToken generado a partir de una Auth Key
Agente que debe ejecutar el servidor por sí mismostdio autohospedadoNinguna para la documentación y el linting; Auth Key para Assemblies

Conéctate mediante URL

Agrega la URL de MCP alojada a tu cliente MCP:

https://api2.transloadit.com/mcp

Aprueba el acceso OAuth en tu navegador y elige el Workspace que puede usar el cliente. No hay ningún servidor local que instalar ni ninguna Auth Key o Auth Secret que copiar. Al aprobarlo, se crea una Auth Key dedicada para la aplicación, limitada a los permisos mostrados; revoca el acceso en Aplicaciones conectadas.

Nota

El servidor alojado te pide iniciar sesión antes de que se ejecute cualquier herramienta, incluidas la documentación de Robots y el linting. Para usarlas sin una cuenta, ejecuta el servidor en modo autohospedado.

CI y clientes sin interfaz

Cuando nadie pueda aprobar el acceso en un navegador, envía un token con la audiencia mcp al endpoint alojado como Authorization: Bearer <token>. Genéralo en un entorno de confianza que tenga una Auth Key y un Auth Secret (TRANSLOADIT_KEY y TRANSLOADIT_SECRET para la CLI):

npx -y @transloadit/node auth token --aud mcp

El comando imprime JSON. Captura solo su valor access_token y pásalo al entorno de ejecución del agente mediante un almacén de secretos o una variable de entorno; no imprimas la respuesta en los logs ni en la transcripción del agente.

  • Caducidad: los tokens caducan tras el intervalo expires_in devuelto (una semana de forma predeterminada para MCP). Genera uno por trabajo o sesión, y genera uno nuevo si el trabajo dura más que ese intervalo.
  • Ámbito: usa --scope para restringir el acceso; de lo contrario, el token hereda los ámbitos de la Auth Key.
  • Revocación: elimina la Auth Key a partir de la cual se generó un token para cortar el acceso antes de que caduque. Usa una Auth Key dedicada para CI.

Consulta CI y clientes sin interfaz para ver ejemplos de configuración de clientes.

Modo stdio autohospedado

Configura el servidor como un comando stdio en tu cliente MCP; la mayoría de los clientes lo inician por ti. La documentación de Robots y el linting funcionan sin una cuenta:

npx -y @transloadit/mcp-server stdio

Para operaciones de cuenta, como crear Assemblies, proporciona TRANSLOADIT_KEY y TRANSLOADIT_SECRET mediante el entorno del proceso del servidor, y establece TRANSLOADIT_SIGNATURE_ALGORITHM para que coincida con la Auth Key. Las claves creadas en la Console con la firma de Smart CDN activada (el valor predeterminado) usan sha256, mientras que el servidor usa sha384 de forma predeterminada; el fragmento de código de la Console para la clave indica qué valor establecer. Consulta la configuración del algoritmo de firma.

El proceso stdio guarda estas credenciales en la máquina del agente, así que usa una Auth Key dedicada solo con los ámbitos que necesite y mantén las credenciales fuera de los archivos de configuración de MCP confirmados en el repositorio.

Para ver ejemplos de configuración de clientes (Claude, Cursor, VS Code/Copilot), detalles de autenticación, documentación de herramientas, límites y las diferencias de comportamiento entre el modo alojado y el autohospedado, consulta la documentación del servidor MCP.

Vías de automatización

Las herramientas de Transloadit para agentes combinan herramientas de ejecución con orientación sobre flujos de trabajo y contexto de documentación. La CLI y MCP ejecutan flujos de trabajo; las Agent Skills y llms.txt ayudan a los agentes a usar esas herramientas:

  • CLI: usa @transloadit/node cuando una persona o un trabajo de CI necesite un comando repetible para crear una Assembly, esperar a que termine y recopilar los resultados.
  • MCP: expone las herramientas de Transloadit a agentes integrados o alojados. El agente puede consultar la documentación de Robots, aplicar lint a las Assembly Instructions, crear Assemblies y seguir las actualizaciones de estado. Para los archivos que se pasan directamente a transloadit_create_assembly, usa URL públicas, archivos pequeños en línea o adjuntos que el cliente transmita. Subir archivos locales o del sandbox mediante el comando de subida devuelto requiere una shell; consulta las entradas compatibles.
  • Agent Skills: mantén bajo control de versiones guías de actuación para flujos de trabajo multimedia específicas de tu equipo, destinadas a agentes que ya tengan herramientas útiles, como acceso a la terminal, MCP, la CLI o los SDK. Las Skills indican al agente qué Templates, pasos de verificación y alternativas de respaldo usar, pero no otorgan nuevas capacidades por sí mismas.
  • llms.txt: proporciona a cualquier LLM un mapa actualizado de los productos, soluciones, integraciones, recursos para desarrolladores y contenido de aprendizaje de Transloadit antes de que proponga una Assembly.

Usa MCP alojado con OAuth en el navegador cuando una persona conecte un cliente de agente interactivo. Para la automatización desatendida, mantén las credenciales en un entorno de confianza: envía un token Bearer con la audiencia mcp al MCP alojado, o proporciona una Auth Key y un Auth Secret al stdio autohospedado, a la CLI o a tu propio backend.

Agent Skills

Las Agent Skills⁠ son archivos Markdown (SKILL.md) que enseñan a los agentes a realizar tareas paso a paso.

Demostración: encoding de videos a streaming adaptativo HLS con las Agent Skills de Transloadit en Claude

En términos prácticos, un servidor MCP es una superficie de API a la que un agente puede llamar en tiempo de ejecución (mediante un proceso MCP local o alojado), mientras que las Skills son guías de actuación bajo control de versiones que le indican a un agente qué hacer, en qué orden y cómo verificarlo. Las Skills no añaden por sí mismas acceso a nuevas herramientas. Codifican cómo quieres que el agente use de forma coherente las herramientas disponibles en tu entorno (MCP, CLI, SDK).

  • Usa MCP para una ejecución integrada y repetible (creación de Assemblies, sondeo, resultados).
  • Usa las Skills como guías de actuación reutilizables y dirigidas por personas para tareas como la configuración inicial, el scaffolding, los Templates y las migraciones.

Además, se complementan entre sí. Una Skill puede estandarizar un flujo de trabajo y luego indicar al agente que use MCP (o la CLI local como alternativa) para la ejecución real.

Instala con la CLI de Skills

npx skills add transloadit/skills

Esto instala todas las 19 Skills de Transloadit en tu proyecto:

  • docs-transloadit-robots

    Consulta sin conexión de los Robots de Transloadit y de la documentación y los ejemplos de sus parámetros mediante la CLI transloadit. Úsala para redactar o validar el JSON de steps sin tener que adivinar nombres ni parámetros de Robots.

  • integrate-asset-delivery-with-transloadit-smartcdn-in-nextjs

    Agregar la firma de URL de Transloadit Smart CDN del lado del servidor para un activo configurado explícitamente a un proyecto de Next.js con App Router.

  • integrate-uppy-transloadit-s3-uploading-to-nextjs

    Agregar Uppy Dashboard y subidas de Transloadit a una aplicación de Next.js con App Router, con generación de firmas del lado del servidor y exportación opcional mediante /s3/store.

  • transform-build-mosaic-collage-with-transloadit

    Creación puntual de un collage de fotos en mosaico justificado (N imágenes locales -> una sola imagen) con la CLI oficial @transloadit/node. Se usa el efecto mosaic del Robot /image/merge para crear una disposición en mosaico justificada con fotos recortadas de forma centrada y se descarga el resultado en una ruta de salida explícita mediante --output.

  • transform-build-polaroid-collage-with-transloadit

    Creación puntual de un collage de fotos tipo Polaroid apiladas (N imágenes locales -> una sola imagen) con la CLI oficial @transloadit/node. Se usa el efecto polaroid-stack del Robot /image/merge y se descarga el resultado en una ruta de salida explícita mediante --output.

  • transform-caption-video-with-transloadit

    Añade subtítulos sencillos incrustados a un video local y descarga el video subtitulado junto con los segmentos de subtítulos en SRT mediante el Builtin caption-video y la CLI oficial de Transloadit.

  • transform-capture-webpage-with-transloadit

    Captura una página web pública o un archivo HTML local como imagen o PDF mediante el Builtin capture-webpage y la CLI oficial de Transloadit.

  • transform-convert-markdown-to-pdf-with-transloadit

    Convierte un documento de Office o un archivo HTML, Markdown o de texto local a PDF mediante el Builtin convert-to-pdf y la CLI oficial de Transloadit. Incluye el flujo de trabajo existente de conversión de Markdown a PDF.

  • transform-describe-image-with-transloadit

    Descripción puntual de una imagen con la CLI oficial @transloadit/node. Usa image describe --fields labels para obtener etiquetas de objetos, o image describe --for wordpress para obtener un JSON estructurado con texto alternativo, título, pie de foto y descripción.

  • transform-encode-hls-video-with-transloadit

    Proceso puntual de encoding HLS (video local -> variantes HLS + lista de reproducción) con Transloadit mediante la CLI transloadit. Usa preferentemente Builtin Templates (builtin/encode-hls-video@latest) y descarga los resultados localmente mediante -o.

  • transform-encode-video-with-transloadit

    Realiza el encoding de un video local como MP4 o WebM para su reproducción en la web mediante el Builtin encode-video y la CLI oficial de Transloadit.

  • transform-extract-text-with-transloadit

    Extrae texto legible o JSON de archivos locales, como PDF, documentos escaneados, fotos y documentos de Office, mediante el Builtin extract-text y la CLI oficial de Transloadit.

  • transform-generate-image-with-transloadit

    Generación puntual de imágenes (prompt -> archivo de imagen) con Transloadit mediante la CLI transloadit. Usa preferentemente image generate para la generación basada solo en texto y la guiada por una entrada, y usa --output cuando necesites una ruta determinista.

  • transform-make-video-covers-with-transloadit

    Crea carátulas a partir de un video local con fotogramas a intervalos regulares, posiciones temporales exactas o selección inteligente mediante el Builtin video-covers y la CLI oficial de Transloadit.

  • transform-prepare-image-with-transloadit

    Prepara imágenes locales para un sitio web con corrección de orientación, redimensionamiento, compresión y conversión de formato mediante el Builtin prepare-image y la CLI oficial de Transloadit.

  • transform-remove-background-with-transloadit

    Elimina el fondo de una foto local y descarga un PNG transparente mediante el Builtin remove-background y la CLI oficial de Transloadit.

  • transform-transcribe-audio-with-transloadit

    Transcribe audio o video local a texto, JSON con marcas de tiempo, SRT o WebVTT mediante el Builtin transcribe y la CLI oficial de Transloadit.

  • transform-upscale-image-with-transloadit

    Aumento puntual de la resolución de imágenes con IA (imagen local -> imagen de mayor resolución) con Transloadit mediante la CLI transloadit. Usa preferentemente la intención image upscale y usa --output para obtener una ruta determinista.

  • transloadit

    Skill principal como punto de entrada para Transloadit. Dirige la tarea a la Skill integrate-*, transform-* o docs-* adecuada y, para obtener un comportamiento determinista, prioriza la ejecución mediante npx -y @transloadit/node ... (CLI).

Descubrimiento automático

El catálogo de Skills también se puede descubrir en transloadit.com/.well-known/skills/index.json, conforme al RFC de Agent Skills Discovery⁠. Esto significa que también puedes instalarlas con:

npx skills add https://transloadit.com

Instalación manual

Clona el repositorio transloadit/skills⁠ o crea un enlace simbólico a él en el directorio de Skills de tu agente:

AgenteRuta
Claude Code.claude/skills/
OpenAI Codex.codex/skills/
Gemini CLI.gemini/skills/
Cursor.cursor/skills/
Windsurf.codeium/windsurf/skills/

llms.txt

Transloadit publica un archivo llms.txt, un índice de navegación compacto para todo el sitio que sigue el estándar llms.txt⁠. Abarca productos y servicios, soluciones, integraciones, índices de medios y tareas, recursos para desarrolladores y de aprendizaje, y soporte.

Para descubrir Robots específicos, usa /docs/robots/llms.txt. El archivo heredado de compatibilidad llms-full.txt incluye en línea los esquemas completos de parámetros de Robot, pero es grande. Usa preferentemente llms.txt para el descubrimiento y obtén solo las páginas Markdown enlazadas que sean relevantes para la tarea.

¿Qué enfoque debería usar?

EnfoqueIdeal paraConfiguración
MCP alojado con OAuthClientes de agente interactivosAgrega la URL y aprueba el acceso en tu navegador
MCP alojado con un token BearerCI y clientes de agente sin interfazGenera un token en un entorno de confianza
MCP autohospedado (stdio)Ejecutar el servidor localmente, documentación y linting sin cuentaConfigura stdio en tu cliente MCP; proporciona claves para las operaciones de cuenta
SDK oficialCódigo de aplicaciónInstala el SDK correspondiente; mantén el Auth Secret en el servidor
CLIScripts, trabajos de CI y linting sin cuentaEjecuta npx -y @transloadit/node; proporciona credenciales para las operaciones de cuenta
Agent SkillsFlujos de trabajo de Transloadit reutilizables y dirigidos por personasInstálalas con un solo comando
llms.txtDar a cualquier LLM un contexto amplio de la documentación de TransloaditObtén la URL

Estos enfoques se complementan entre sí. Empieza con MCP alojado y OAuth en el navegador para el acceso interactivo a herramientas. Para herramientas de agentes desatendidas, envía un token Bearer al MCP alojado o proporciona una Auth Key y un Auth Secret al stdio autohospedado. Usa un SDK oficial para el código de aplicación, o la CLI para scripts y trabajos de CI. Instala Skills para obtener orientación sobre flujos de trabajo y dirige tu LLM a llms.txt para obtener contexto de documentación.

Página anterior ← WorkspacesPágina siguiente Parámetro use avanzado →
Contactar a soporte
TransloaditVerificando el estado…

Producto

  • Servicios
  • Precios
  • Demos EN (English)
  • Herramientas
  • Seguridad
  • Soporte

Empresa

  • Acerca de Transloadit/Prensa
  • Blog/Empleos EN (English)
  • Comparaciones/Matriz de cumplimiento
  • Investigación EN (English)
  • Código abierto
  • Soluciones
  • Pioneros de la web

Documentación

  • Primeros pasos
  • Transcodificación
  • FAQ
  • Endpoints de la API
  • Guías/Consejos para desarrolladores
  • Formatos compatibles

Más

  • Estado de la plataforma⁠
  • Foro de la comunidad⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®, el protocolo tus® y Uppy® son marcas registradas de Transloadit-II GmbH en Estados Unidos.

Privacidad EN (English)Términos EN (English)Aviso legal EN (English)Marcas comerciales EN (English)Política de DMCA EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語