Communitygithub.com

Adobe Redimensionar Fotos e Vídeos

Redimensiona fotos e vídeos para dimensões exatas em pixels ou proporções de aspecto usando ferramentas Adobe.

O que é Adobe Redimensionar Fotos e Vídeos?

Esta skill capacita agentes de IA a redimensionar imagens e vídeos utilizando as ferramentas Adobe, atendendo a solicitações como 'redimensionar para 1920x1080', 'tornar 4K', 'mudar proporção para 16:9' e outras. Ela oferece um fluxo de trabalho completo: desde a inicialização obrigatória (`adobe_mandatory_init`), verificação de licenciamento, captura de parâmetros via perguntas ao usuário (tipo, dimensões, modo de ajuste, foco inteligente), até o processamento com ferramentas específicas como `image_crop_and_resize` para imagens e `video_resize` para vídeos. Suporta múltiplas saídas, processamento em lote e criação de quadros no Firefly. A skill também lida com polling para redimensionamento de vídeos e gerencia grandes lotes paginados entre turnos de conversa.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adobe/skills/tree/HEAD/plugins/creative-cloud/adobe-for-creativity/skills/adobe-resize-photos-and-videos

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Adobe Redimensionar Fotos e Vídeos faz?

Redimensiona imagens ou vídeos para dimensões especificadas pelo usuário, proporção de aspecto ou tamanho nomeado. Para conjuntos de plataformas de mídia social (Instagram, TikTok, etc.) → use a skill adobe-create-social-variations.


Referência de Ferramentas

EtapaFerramentaObservações
Abrir seletor de arquivosasset_add_fileRetorna presignedAssetUrl, assetId e mediaType
Encontrar ativo no CCasset_searchReencenar resultado via asset_add_file para imagem; usar id diretamente para vídeo
Renderizar PSD/AIdocument_render_vectorConverte para JPEG antes de redimensionar
Redimensionar imagemimage_crop_and_resizeUma chamada por dimensão; reframe por padrão
Visualizar saídasasset_preview_fileTodas as saídas em uma única chamada
Upload para CC (início)asset_initialize_file_uploadPrimeira chamada no pipeline de upload em bloco
Upload para CC (fim)asset_finalize_file_uploadSegunda chamada; retorna URL CC presigned para o quadro
Criar quadro Fireflycreate_firefly_boardPassar import_adobe_storage com URL finalizada
Redimensionar vídeovideo_resizeRetorna statusId para polling
Polling de redimensionamento de vídeoresizeVideoPollFerramenta adiada — carregar antes de chamar

Fluxo de Trabalho

Etapa 0 — Inicializar Ferramentas Adobe

Chame adobe_mandatory_init primeiro. Isso retorna regras de manipulação de arquivos e orientação de roteamento de ferramentas necessárias para o resto do fluxo de trabalho.

{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }

Etapa 1 — Verificação de Licenciamento

Agora que adobe_mandatory_init confirmou que o conector "Adobe para criatividade" está ativo, verifique quais ferramentas estão disponíveis através do conector "Adobe para criatividade" cruzando com a tabela de Referência de Ferramentas acima.


AÇÃO IMEDIATA REQUERIDA

Etapa 1: Se os parâmetros estiverem ausentes ou ambíguos → execute a captura de múltiplas etapas (Etapa 2 abaixo). Etapa 2: Se nenhum arquivo foi enviado, execute a Etapa 3 (asset_add_file({})). Etapa 3: Detecte imagem vs. vídeo e roteie para o fluxo de trabalho correto (Etapa 5 Imagem/Vídeo).


Etapa 2 — Captura de Múltiplas Etapas

Execute isso quando o usuário não forneceu parâmetros completos (tipo + dimensões + modo de ajuste). Pule totalmente se a mensagem do usuário já contiver todos os três.

Use AskUserQuestion para coletar parâmetros passo a passo.

Etapa 2a — Tipo

AskUserQuestion([{
  question: "Foto ou vídeo?",
  type: "single_select",
  options: ["Foto", "Vídeo"]
}])

Etapa 2b — Dimensões

Se Foto (multi_select — o usuário pode escolher um ou mais):

AskUserQuestion([{
  question: "Dimensões — selecione todas que precisa",
  type: "multi_select",
  options: [
    "1080 × 1080 — Quadrado Instagram",
    "1080 × 1350 — Retrato Instagram",
    "1080 × 1920 — Stories / Reels",
    "1920 × 1080 — YouTube / paisagem",
    "1280 × 720 — Miniatura YouTube",
    "1200 × 675 — Postagem X / Twitter",
    "1200 × 630 — Facebook / imagem OG",
    "1080 × 566 — Postagem LinkedIn",
    "2560 × 1440 — Banner YouTube",
    "3840 × 2160 — 4K / UHD",
    "400 × 400 — Perfil / avatar",
    "2480 × 3508 — Impressão A4 (300 dpi)",
    "Personalizado — Vou digitar"
  ]
}])

Se o usuário incluir "Personalizado" → pergunte em seguida: "Digite suas dimensões personalizadas (ex.: 1500×800):"

Se o usuário selecionar várias predefinições → execute image_crop_and_resize uma vez por dimensão, usando a mesma URI de origem e parâmetros. Visualize todas as saídas juntas no final.

Se Vídeo (multi_select — o usuário pode escolher um ou mais):

AskUserQuestion([{
  question: "Dimensões — selecione todas que precisa",
  type: "multi_select",
  options: [
    "1080 × 1920 — Reels / TikTok / Stories",
    "1920 × 1080 — YouTube / paisagem",
    "1080 × 1080 — Postagem quadrada",
    "1280 × 720 — YouTube 720p",
    "3840 × 2160 — 4K / UHD",
    "854 × 480 — SD / 480p",
    "Personalizado — Vou digitar"
  ]
}])

Se o usuário selecionar várias predefinições de vídeo → envie um trabalho video_resize separado por dimensão, faça polling de cada até a conclusão, visualize todas as saídas juntas.

Etapa 2c — Modo de Ajuste

Se Foto (single_select):

AskUserQuestion([{
  question: "Modo de ajuste",
  type: "single_select",
  options: [
    "Reenquadrar — cortar para preencher",
    "Preencher com espaço — letterbox, sem corte",
    "Extrair — isolar assunto"
  ]
}])

Se Vídeo (single_select):

AskUserQuestion([{
  question: "Modo de ajuste",
  type: "single_select",
  options: [
    "Letterbox — preservar proporção",
    "Cortar — preencher, sem barras",
    "Esticar — forçar exato (distorcer)"
  ]
}])

Etapa 2d — Foco inteligente (Apenas Foto)

AskUserQuestion([{
  question: "Foco inteligente — onde centralizar o corte?",
  type: "single_select",
  options: [
    "Assunto",
    "Rosto / retrato",
    "Parte superior do corpo",
    "Centro (geométrico)",
    "Objeto nomeado — Vou descrevê-lo"
  ]
}])

Se o usuário selecionar "Objeto nomeado" → pergunte em seguida: "Descreva o objeto (ex.: 'o carro vermelho', 'o logotipo'):"

Etapa 2e — Opções (Apenas Foto)

AskUserQuestion([{
  question: "Opções adicionais?",
  type: "multi_select",
  options: [
    "Lote — várias imagens",
    "Saída: JPEG",
    "Saída: PNG"
  ]
}])

Etapa 2f — Origem (Apenas Vídeo)

AskUserQuestion([{
  question: "Onde está o vídeo?",
  type: "single_select",
  options: [
    "Enviar do dispositivo",
    "Do Creative Cloud"
  ]
}])

Etapa 3 — Obter o Arquivo de Origem

Crítico — caminhos /mnt/user-data/uploads/ NÃO são URLs utilizáveis. Mesmo quando o usuário anexou um arquivo e ele aparece no contexto em um caminho /mnt/user-data/uploads/, você não pode passar este caminho para nenhuma ferramenta Adobe. Chame asset_add_file() para encenar o arquivo — caminhos /mnt/user-data/uploads/ não são buscáveis por ferramentas Adobe.

ERRADO  ❌  imageURI: "/mnt/user-data/uploads/foto.jpg"
ERRADO  ❌  imageURI: "file:///mnt/user-data/uploads/foto.jpg"
CORRETO ✅  chamar asset_add_file() → usar presignedAssetUrl do contexto do seletor

Nenhum arquivo ainda → abra o seletor imediatamente:

asset_add_file()

Detecte o tipo a partir do mediaType retornado:

  • image/* → FLUXO DE TRABALHO DE IMAGEM
  • video/* → FLUXO DE TRABALHO DE VÍDEO

Etapa 4 — Resolver Dimensões Alvo

O usuário dizResolver para
1920×1080, 1920x1080largura: 1920, altura: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
Impressão A42480 × 3508 (300 DPI retrato)
Impressão Carta2550 × 3300 (300 DPI retrato)
16:9, 1:1, 4:5, 9:16string de proporção → passar como output: "16:9"
quadradooutput: "1:1"
Apenas largura (800px de largura)largura: 800, usar string de proporção para manter aspecto

Se nenhum alvo foi especificado no formulário E nenhum na mensagem do usuário → pergunte:

"Quais dimensões você precisa? (ex.: 1920×1080, A4, 16:9)"


FLUXO DE TRABALHO DE IMAGEM

Etapa 5 (Imagem) — Fontes URI Válidas

Apenas estas funcionam como imageURI:

  • presignedAssetUrl de asset_add_file() ✅
  • outputUrl de uma chamada de ferramenta anterior ✅
  • URL HTTPS pública fornecida pelo usuário ✅

Não utilizáveis como imageURI:

  • Caminhos /mnt/user-data/uploads/ ❌
  • renditionURL de asset_search diretamente ❌
  • URIs file:// ❌
FonteResolução
Arquivo enviadoasset_add_file() → presignedAssetUrl
Ativo do armazenamento CCasset_search → reencenar via asset_add_file() → presignedAssetUrl
Saída de ferramenta anteriorUsar outputUrl diretamente
Arquivo PSD / AIdocument_render_vector (JPEG, 300 DPI) → outputPresignedUrl

Etapa 6 (Imagem) — Modo de Ajuste

IntençãoModoObservações
"redimensionar para LxA" / padrãoreframeMaior corte na proporção alvo, centralizado — sem distorção
"sem corte", "letterbox", "ajustar dentro"padPreenche espaço vazio com branco
"isolar assunto", "corte apertado"extractCorte apertado ao redor da região detectada

Padrão: reframe. Altere apenas quando o usuário for explícito.

⛔ fit: "extract" é incompatível com { width, height } explícito — ele estica a imagem. Use uma string de proporção ou omita output.


Etapa 7 (Imagem) — Chamar image_crop_and_resize

image_crop_and_resize({
  imageURI: presignedAssetUrl,
  options: {
    output: { width: 1920, height: 1080 },  // ou "16:9"
    fit: "reframe",
    focus: "subject",  // ou "face", "upper_body", { prompt: "o carro" }, { x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // ou "png" se precisar de transparência
})
// result.outputUrl → usar para visualização ou encadeamento

Guia de foco:

  • "subject" — padrão; detecção de corpo inteiro, paisagens, objetos
  • "face" — retratos, fotos de rosto
  • "upper_body" — cortes do peito para cima
  • { prompt: "o logotipo" } — objeto nomeado da entrada do formulário do usuário
  • { x: 0.5, y: 0.5 } — centro geométrico (sem assunto claro)

Etapa 8 (Imagem) — Lote

Se lote foi selecionado no formulário OU o usuário forneceu vários arquivos:

  1. Chame asset_add_file() para cada arquivo para obter URLs presigned individuais
  2. Chame image_crop_and_resize para cada um com os mesmos parâmetros
  3. Colete todos os valores outputUrl
  4. Chame asset_preview_file com todas as saídas em uma única chamada

As chamadas são executadas sequencialmente neste ambiente. Para >10 imagens, confirme com o usuário antes de iniciar.

Paginação entre turnos (lotes >20): Para lotes grandes, o contexto da conversa pode encher antes que todas as imagens sejam processadas, levando Claude a pausar no meio do lote. Isso é esperado — não é um erro. Quando acontecer:

  • Diga quantas foram concluídas e quantas restam (ex.: "20 / 24 concluídas — diga 'continuar' para o restante")
  • Aguarde a confirmação do usuário antes de retomar
  • Ao retomar, comece da próxima imagem não processada e continue até o final
  • Visualize todas as saídas juntas apenas após a imagem final ser concluída

Etapa 9 (Imagem) — Visualizar + Entregar + Quadro Firefly

asset_preview_file({
  assets: [
    { name: "foto_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
    // todas as saídas bem-sucedidas
  ]
})

Salvar no CC + Criar Quadro Firefly

Após a visualização, envie cada saída para o armazenamento CC usando o pipeline de upload em bloco (asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).

Em seguida, chame a ferramenta de quadro firefly com as URLs de saída finais:

create_firefly_board({
  import_adobe_storage: [
    url_saida_final_1,
    url_saida_final_2,
    // ...
  ]
})

✅ Confirmado funcionando (Stage): import_adobe_storage com URLs presigned de asset_finalize_file_upload preenche quadros com sucesso.

❌ Não funciona: import_generic_assets com IDs de ativos CC (urn:aaid:sc:US:...) — atraso de indexação USS causa quadros em branco.

Se a criação do quadro falhar ou a URL estiver malformada, omita o link do quadro (repetir não ajuda).

Poste o resumo de conclusão após a etapa do quadro:

✅ Concluído! [N] imagem(ns) redimensionada(s) e pronta(s).

📥 Download:
• redimensionada_1920x1080.jpg → <url_armazenamento_cc>
[listar individualmente se N ≤ 3, ou link de pasta único se N > 3]

🎨 Ver no Quadro Firefly → <url_quadro>   ← omitir se a criação do quadro falhou

FLUXO DE TRABALHO DE VÍDEO

Etapa 5 (Vídeo) — Obter ID do Ativo

Ferramentas de vídeo requerem assetId, não uma URL.

FonteComo
Envio via asset_add_fileUsar assetId retornado
Armazenamento CCasset_search com filters.mediaType: "video/mp4" → usar id do ativo

Etapa 6 (Vídeo) — Alvos Comuns

NomeDimensões
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
Vertical 9:161080 × 1920
Quadrado 1:11080 × 1080

Etapa 7 (Vídeo) — Chamar video_resize

⚠️ resizeVideoPoll é uma ferramenta adiada — carregue-a primeiro antes de tentar fazer polling. Chamadas diretas sem carregamento falharão com erro "not loaded" (não carregada).

video_resize({
  assetId: idVideo,
  width: larguraAlvo,
  height: alturaAlvo,
  mode: "letterbox"  // padrão; veja tabela de modos abaixo
})
// Retorna { jobStatus: "pending", statusId }

Modo — usar valores exatos da API (não rótulos voltados ao usuário):

O usuário dizValor APIComportamento
"ajustar", "preservar proporção", "letterbox""letterbox"Preserva proporção, adiciona barras pretas (padrão)
"preencher", "cortar para preencher", "sem barras""crop"Corta bordas para preencher exatamente o alvo
"esticar", "forçar exato""stretch"Distorce para o alvo exato

ℹ️ Reenquadramento automático para vídeo não está disponível no Claude ainda, mas novas ferramentas estão sendo adicionadas o tempo todo. Se precisar de mais controle, experimente usar o Adobe Premiere.

Polling: Carregue a ferramenta adiada resizeVideoPoll antes de chamá-la — chamadas diretas falham com "not loaded" (não carregada).

// Passo 1: carregar a ferramenta adiada
const pollTool = await loadTool('resizeVideoPoll');

// Passo 2: usar a ferramenta carregada para polling
const status = await pollTool({ statusId: idStatus });
// status.jobStatus pode ser "pending", "complete", "failed"

Etapa 8 (Vídeo) — Visualizar + Entregar + Quadro Firefly

asset_preview_file({
  assets: [
    { name: "video_1920x1080.mp4", presignedAssetUrl: urlSaida },
    // todas as saídas bem-sucedidas
  ]
})

Salvar no CC + Criar Quadro Firefly

Após a visualização, faça upload de cada saída para o armazenamento CC e crie um quadro Firefly, assim como no fluxo de trabalho de imagem.


Boas Práticas

  1. Sempre chame adobe_mandatory_init primeiro. Todas as ferramentas Adobe dependem disso.
  2. Nunca passe caminhos de arquivo locais para ferramentas de redimensionamento. Use asset_add_file().
  3. Para múltiplas saídas, agrupe visualizações e quadros. Uma única chamada de visualização para todas as saídas é mais rápida e consome menos tokens.
  4. Lotes grandes (>20) podem exigir paginação entre turnos. Reconheça, peça ao usuário para "continuar" e retome do ponto onde parou.
  5. Se a criação do quadro Firefly falhar, apenas omita o link. Tentar novamente não ajuda.
  6. Ferramentas adiadas precisam ser carregadas antes do uso. resizeVideoPoll é uma ferramenta desse tipo.

Perguntas Comuns

"Por que meu arquivo não é aceito?"

  • Arquivos PSD/AI requerem document_render_vector primeiro.
  • Vídeos requerem assetId, não uma URL.
  • Caminhos locais (/mnt/user-data/uploads/) nunca funcionam.

"Posso redimensionar em lote?"

Sim. Selecione "Lote" no formulário ou forneça vários arquivos. Cada um é processado sequencialmente; você pode visualizar todos juntos no final.

"E se eu precisar de um tamanho personalizado?"

Selecione "Personalizado" no formulário de dimensões ou digite no formato L×A (ex.: 1500×800).


Solução de Problemas

ProblemaCausa provávelSolução
asset_add_file retorna erroCaminho de arquivo inválido ou ausenteCertifique-se de que o arquivo existe e tente novamente
image_crop_and_resize falhaimageURI inacessívelUse presignedAssetUrl de asset_add_file
video_resize trava em "pending"Ferramenta de polling não carregadaCarregue resizeVideoPoll antes de fazer polling
Quadro Firefly vazioimport_generic_assets não funcionaUse import_adobe_storage com URLs presigned
Lote grande para no meioContexto da conversa cheioPeça ao usuário para "continuar" e retome

Habilidades Relacionadas