Adobe Redimensionar Fotos y Vídeos
Redimensiona imágenes o vídeos a dimensiones especificadas por el usuario, relación de aspecto o tamaño predefinido.
Para conjuntos de plataformas sociales (Instagram, TikTok, etc.) → usa la habilidad adobe-create-social-variations en su lugar.
Referencia de Herramientas
| Paso | Herramienta | Notas |
|---|---|---|
| Abrir selector de archivos | asset_add_file | Devuelve presignedAssetUrl, assetId y mediaType |
| Buscar activo en CC | asset_search | Re-escalona el resultado mediante asset_add_file para imagen; usa id directamente para vídeo |
| Renderizar PSD/AI | document_render_vector | Convierte a JPEG antes de redimensionar |
| Redimensionar imagen | image_crop_and_resize | Una llamada por dimensión; reframe por defecto |
| Previsualizar salidas | asset_preview_file | Todas las salidas en una sola llamada |
| Subir a CC (inicio) | asset_initialize_file_upload | Primera llamada en la canalización de subida por bloques |
| Subir a CC (fin) | asset_finalize_file_upload | Segunda llamada; devuelve URL presigned de CC para el tablero |
| Crear tablero Firefly | create_firefly_board | Pasa import_adobe_storage con la URL finalizada |
| Redimensionar vídeo | video_resize | Devuelve statusId para sondeo |
| Sondeo de redimensionamiento de vídeo | resizeVideoPoll | Herramienta diferida: cárgala antes de usarla |
Flujo de trabajo
Paso 0 — Inicializar herramientas de Adobe
Llama primero a adobe_mandatory_init. Esto devuelve reglas de manejo de archivos y guía de enrutamiento de herramientas necesarias para el resto del flujo.
{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }
Paso 1 — Verificación de permisos
Ahora que adobe_mandatory_init confirmó que el conector "Adobe for creativity" está activo, verifica qué herramientas están disponibles a través del conector "Adobe for creativity" cotejando con la tabla de Referencia de Herramientas anterior.
ACCIÓN INMEDIATA REQUERIDA
Paso 1: Si faltan parámetros o son ambiguos → ejecuta la toma de requisitos de varios pasos (Paso 2 a continuación).
Paso 2: Si no se ha subido ningún archivo, ejecuta el Paso 3 (asset_add_file({})).
Paso 3: Detecta si es imagen o vídeo y enruta al flujo correcto (Paso 5 Imagen/Vídeo).
Paso 2 — Toma de requisitos de varios pasos
Ejecuta esto cuando el usuario no haya proporcionado parámetros completos (tipo + dimensiones + modo de ajuste). Omítelo por completo si el mensaje del usuario ya contiene los tres.
Usa AskUserQuestion para recopilar los parámetros paso a paso.
Paso 2a — Tipo
AskUserQuestion([{
question: "¿Foto o vídeo?",
type: "single_select",
options: ["Foto", "Vídeo"]
}])
Paso 2b — Dimensiones
Si es Foto (multi_select — el usuario puede elegir una o más):
AskUserQuestion([{
question: "Dimensiones — selecciona todas las que necesites",
type: "multi_select",
options: [
"1080 × 1080 — Cuadrado de Instagram",
"1080 × 1350 — Retrato de Instagram",
"1080 × 1920 — Historias / Reels",
"1920 × 1080 — YouTube / horizontal",
"1280 × 720 — Miniatura de YouTube",
"1200 × 675 — Publicación en X / Twitter",
"1200 × 630 — Facebook / imagen OG",
"1080 × 566 — Publicación en LinkedIn",
"2560 × 1440 — Banner de YouTube",
"3840 × 2160 — 4K / UHD",
"400 × 400 — Perfil / avatar",
"2480 × 3508 — Impresión A4 (300 ppp)",
"Personalizado — lo escribiré"
]
}])
Si el usuario incluye "Personalizado" → pregunta: "Introduce tus dimensiones personalizadas (ej. 1500×800):"
Si el usuario selecciona varios preajustes → ejecuta image_crop_and_resize una vez por cada dimensión,
usando la misma URI de origen y parámetros cada vez. Previsualiza todas las salidas juntas al final.
Si es Vídeo (multi_select — el usuario puede elegir una o más):
AskUserQuestion([{
question: "Dimensiones — selecciona todas las que necesites",
type: "multi_select",
options: [
"1080 × 1920 — Reels / TikTok / Historias",
"1920 × 1080 — YouTube / horizontal",
"1080 × 1080 — Publicación cuadrada",
"1280 × 720 — YouTube 720p",
"3840 × 2160 — 4K / UHD",
"854 × 480 — SD / 480p",
"Personalizado — lo escribiré"
]
}])
Si el usuario selecciona varios preajustes de vídeo → envía un trabajo video_resize separado por cada dimensión,
sondea cada uno hasta completarlos, previsualiza todas las salidas juntas.
Paso 2c — Modo de ajuste
Si es Foto (single_select):
AskUserQuestion([{
question: "Modo de ajuste",
type: "single_select",
options: [
"Reencuadrar — recortar para llenar",
"Rellenar — bandas negras, sin recorte",
"Extraer — aislar sujeto"
]
}])
Si es Vídeo (single_select):
AskUserQuestion([{
question: "Modo de ajuste",
type: "single_select",
options: [
"Letterbox — preservar proporción",
"Recortar — llenar, sin barras",
"Estirar — forzar exacto (distorsionar)"
]
}])
Paso 2d — Enfoque inteligente (solo Foto)
AskUserQuestion([{
question: "Enfoque inteligente — ¿dónde debe centrarse el recorte?",
type: "single_select",
options: [
"Sujeto",
"Rostro / retrato",
"Parte superior del cuerpo",
"Centro (geométrico)",
"Objeto nombrado — lo describiré"
]
}])
Si el usuario selecciona "Objeto nombrado" → pregunta: "Describe el objeto (ej. 'el coche rojo', 'el logo'):"
Paso 2e — Opciones (solo Foto)
AskUserQuestion([{
question: "¿Alguna opción adicional?",
type: "multi_select",
options: [
"Lote — múltiples imágenes",
"Salida: JPEG",
"Salida: PNG"
]
}])
Paso 2f — Origen (solo Vídeo)
AskUserQuestion([{
question: "¿Dónde está el vídeo?",
type: "single_select",
options: [
"Subir desde el dispositivo",
"Desde Creative Cloud"
]
}])
Paso 3 — Obtener el archivo de origen
Importante — las rutas /mnt/user-data/uploads/ NO son URLs utilizables.
Incluso cuando el usuario ha adjuntado un archivo y aparece en el contexto en una ruta /mnt/user-data/uploads/,
no puedes pasar esta ruta a ninguna herramienta de Adobe. Llama a asset_add_file() para preparar el archivo — las rutas /mnt/user-data/uploads/ no son recuperables por las herramientas de Adobe.
INCORRECTO ❌ imageURI: "/mnt/user-data/uploads/photo.jpg"
INCORRECTO ❌ imageURI: "file:///mnt/user-data/uploads/photo.jpg"
CORRECTO ✅ llama a asset_add_file() → usa presignedAssetUrl del contexto del selector
Aún no hay archivo → abre el selector inmediatamente:
asset_add_file()
Detecta el tipo a partir del mediaType devuelto:
image/*→ FLUJO DE IMAGENvideo/*→ FLUJO DE VÍDEO
Paso 4 — Resolver dimensiones objetivo
| El usuario dice | Resolver a |
|---|---|
1920×1080, 1920x1080 | ancho: 1920, alto: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
Impresión A4 | 2480 × 3508 (300 DPI vertical) |
Impresión Carta | 2550 × 3300 (300 DPI vertical) |
16:9, 1:1, 4:5, 9:16 | cadena de proporción → pasar como output: "16:9" |
cuadrado | output: "1:1" |
Solo ancho (800px de ancho) | ancho: 800, usa cadena de proporción para mantener relación de aspecto |
Si no se especificó ningún objetivo en el formulario Y ninguno en el mensaje del usuario → pregunta:
"¿Qué dimensiones necesitas? (ej. 1920×1080, A4, 16:9)"
FLUJO DE IMAGEN
Paso 5 (Imagen) — Fuentes URI válidas
Solo estas funcionan como imageURI:
presignedAssetUrldeasset_add_file()✅outputUrlde una llamada de herramienta anterior ✅- URL HTTPS pública proporcionada por el usuario ✅
No usable como imageURI:
- Rutas
/mnt/user-data/uploads/❌ renditionURLdeasset_searchdirectamente ❌- URIs
file://❌
| Origen | Resolución |
|---|---|
| Archivo subido | asset_add_file() → presignedAssetUrl |
| Activo en almacén CC | asset_search → re-escalonar mediante asset_add_file() → presignedAssetUrl |
| Salida de herramienta anterior | Usa outputUrl directamente |
| Archivo PSD / AI | document_render_vector (JPEG, 300 DPI) → outputPresignedUrl |
Paso 6 (Imagen) — Modo de ajuste
| Intención | Modo | Notas |
|---|---|---|
| "redimensionar a WxH" / por defecto | reframe | Recorte más grande en la proporción objetivo, centrado — sin distorsión |
| "sin recortar", "letterbox", "ajustar dentro" | pad | Rellena el espacio vacío con blanco |
| "aislar sujeto", "recorte ajustado" | extract | Recorte ajustado alrededor de la región detectada |
Por defecto: reframe. Cámbialo solo cuando el usuario sea explícito.
⛔
fit: "extract"es incompatible con un{ width, height }explícito — estira la imagen. Usa una cadena de proporción u omiteoutput.
Paso 7 (Imagen) — Llamar a image_crop_and_resize
image_crop_and_resize({
imageURI: presignedAssetUrl,
options: {
output: { width: 1920, height: 1080 }, // o "16:9"
fit: "reframe",
focus: "subject", // o "face", "upper_body", { prompt: "the car" }, { x:0.5, y:0.5 }
quality: 7
},
outputFileType: "jpeg" // o "png" si se necesita transparencia
})
// result.outputUrl → usar para previsualización o encadenamiento
Guía de enfoque:
"subject"— por defecto; detección de cuerpo completo, paisajes, objetos"face"— retratos, primeros planos"upper_body"— recortes de pecho hacia arriba{ prompt: "the logo" }— objeto nombrado de la entrada del formulario del usuario{ x: 0.5, y: 0.5 }— centro geométrico (sin sujeto claro)
Paso 8 (Imagen) — Lote
Si se seleccionó lote en el formulario O el usuario proporcionó varios archivos:
- Llama a
asset_add_file()por cada archivo para obtener URLs presigned individuales - Llama a
image_crop_and_resizepor cada uno con los mismos parámetros - Recoge todos los valores
outputUrl - Llama a
asset_preview_filecon todas las salidas en una sola llamada
Las llamadas se ejecutan secuencialmente en este entorno. Para más de 10 imágenes, confirma con el usuario antes de comenzar.
Paginación entre turnos (lotes >20): Para lotes grandes, el contexto de la conversación puede llenarse antes de que se procesen todas las imágenes, lo que hace que Claude se detenga a mitad del lote. Esto es esperado — no es un error. Cuando ocurra:
- Indica cuántas se han completado y cuántas quedan (ej. "20 / 24 hechas — di 'continuar' para el resto")
- Espera a que el usuario confirme antes de reanudar
- Al reanudar, continúa desde la siguiente imagen no procesada y sigue hasta el final
- Previsualiza todas las salidas juntas solo después de que se complete la imagen final
Paso 9 (Imagen) — Previsualizar + Entregar + Tablero Firefly
asset_preview_file({
assets: [
{ name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
// todas las salidas exitosas
]
})
Guardar en CC + Crear tablero Firefly
Después de la previsualización, sube cada salida al almacenamiento CC usando la canalización de subida por bloques
(asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).
Luego llama a la herramienta de tablero Firefly con las URLs de salida finales:
create_firefly_board({
import_adobe_storage: [
final_output_url_1,
final_output_url_2,
// ...
]
})
✅ Confirmado que funciona (Stage):
import_adobe_storagecon URLs presigned deasset_finalize_file_uploadllena tableros con éxito.❌ No funciona:
import_generic_assetscon IDs de activos CC (urn:aaid:sc:US:...) — el retraso de indexación USS causa tableros en blanco.Si la creación del tablero falla o la URL está mal formada, omite el enlace del tablero (reintentar no ayuda).
Publica el resumen de finalización después del paso del tablero:
✅ ¡Hecho! [N] imagen(es) redimensionada(s) y lista(s).
📥 Descargar:
• resized_1920x1080.jpg → <cc_storage_url>
[lista individualmente si N ≤ 3, o enlace de carpeta única si N > 3]
🎨 Ver en tablero Firefly → <board_url> ← omitir si la creación del tablero falló
FLUJO DE VÍDEO
Paso 5 (Vídeo) — Obtener ID del activo
Las herramientas de vídeo requieren assetId, no una URL.
| Origen | Cómo |
|---|---|
Subir mediante asset_add_file | Usa el assetId devuelto |
| Almacenamiento CC | asset_search con filters.mediaType: "video/mp4" → usa el id del activo |
Paso 6 (Vídeo) — Objetivos comunes
| Nombre | Dimensiones |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| Vertical 9:16 | 1080 × 1920 |
| Cuadrado 1:1 | 1080 × 1080 |
Paso 7 (Vídeo) — Llamar a video_resize
⚠️
resizeVideoPolles una herramienta diferida — cárgala primero antes de intentar sondear. Las llamadas directas sin cargarla fallarán con error "no cargada".
video_resize({
assetId: videoAssetId,
width: targetW,
height: targetH,
mode: "letterbox" // por defecto; ver tabla de modos a continuación
})
// Devuelve { jobStatus: "pending", statusId }
Modo — usa valores exactos de la API (no etiquetas para el usuario):
| El usuario dice | Valor API | Comportamiento |
|---|---|---|
| "ajustar", "preservar proporción", "letterbox" | "letterbox" | Preserva la proporción, añade barras negras (por defecto) |
| "llenar", "recortar para llenar", "sin barras" | "crop" | Recorta los bordes para llenar exactamente el objetivo |
| "estirar", "forzar exacto" | "stretch" | Distorsiona para ajustarse exactamente al objetivo |
ℹ️ El reencuadre automático para vídeo no está disponible en Claude aún, pero se están añadiendo nuevas herramientas constantemente. Si necesitas más control, prueba con Adobe Premiere.
Sondeo: carga la herramienta diferida resizeVideoPoll antes de llamarla — las llamadas directas fallan con "no cargada".
// Paso 1: cargar la herramienta diferida
const resizeVideoPoll = await loadTool("resizeVideoPoll");
// Paso 2: sondear el estado
const pollResult = await resizeVideoPoll({ statusId: recibidoStatusId });
Paso 8 (Vídeo) — Previsualizar + Entregar
Una vez que el sondeo devuelva jobStatus: "completed", la salida está lista en el almacenamiento CC.
// Obtener el activo de salida mediante su ID
const updatedAsset = await asset_search({ filters: { id: assetId } });
// Previsualizar el vídeo redimensionado
asset_preview_file({
assets: [
{ name: "video_1920x1080.mp4", assetId: updatedAsset.id }
]
})
// Si asset_preview_file no acepta assetId, obtén una URL presigned mediante asset_add_file({ assetId })
Guardar en CC + Crear tablero Firefly
await initializeFileUpload(...);
await finalizeFileUpload(...);
create_firefly_board({
import_adobe_storage: [final_adobe_storage_url]
})
Publica un mensaje de finalización:
✅ Vídeo redimensionado y listo.
📥 Descargar: · video_1920x1080.mp4 → <enlace_cc>
🎨 Ver en tablero Firefly → <enlace_tablero>
Consejos de calidad
Imágenes
- Calidad (
quality): Rango 0–10; 7 es un buen equilibrio entre calidad y tamaño de archivo. Usa 10 para salida final, 5 para borradores rápidos. - Tipo de archivo de salida:
"jpeg"para fotos,"png"para gráficos con transparencia.
Vídeos
- Elevación: El flujo de trabajo de vídeo no puede elevar la resolución — si la fuente tiene menos píxeles que el objetivo, el vídeo se verá borroso.
- Múltiples salidas: Múltiples dimensiones significan múltiples trabajos, cada uno con su propio ID de sondeo. Gestiona cada uno de forma independiente.
Manejo de errores
| Error | Causa | Solución |
|---|---|---|
"not loaded" en resizeVideoPoll | No se cargó la herramienta diferida | Usa loadTool("resizeVideoPoll") primero, no la llames directamente |
"Asset not found" | AssetId incorrecto o vencido | Vuelve a obtener el activo mediante asset_search o asset_add_file |
| Tablero Firefly en blanco | Importación con IDs de activos CC | Usa import_adobe_storage con URLs presigned en su lugar |
"Invalid imageURI" | Se pasó una ruta /mnt/user-data/uploads/ | Siempre usa asset_add_file() para obtener una URL presigned |
Ejemplo de sesión
Usuario: "Redimensiona esta foto a 1920x1080"
Agente: "Claro. Voy a redimensionar esta foto a 1920×1080 con recorte centrado."
- Llama a
asset_add_file()→ obtiene URL presigned - Detecta
mediaType: "image/jpeg"→ usa flujo de imagen - Llama a
image_crop_and_resize({ imageURI, options: { output: { width: 1920, height: 1080 }, fit: "reframe", focus: "subject" }, outputFileType: "jpeg" }) - Llama a
asset_preview_file({ assets: [{ name: "photo_1920x1080.jpg", presignedAssetUrl: resultado.outputUrl }] }) - Sube a CC y crea tablero Firefly
- Publica resumen de finalización con enlaces de descarga y tablero