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
| Etapa | Ferramenta | Observações |
|---|---|---|
| Abrir seletor de arquivos | asset_add_file | Retorna presignedAssetUrl, assetId e mediaType |
| Encontrar ativo no CC | asset_search | Reencenar resultado via asset_add_file para imagem; usar id diretamente para vídeo |
| Renderizar PSD/AI | document_render_vector | Converte para JPEG antes de redimensionar |
| Redimensionar imagem | image_crop_and_resize | Uma chamada por dimensão; reframe por padrão |
| Visualizar saídas | asset_preview_file | Todas as saídas em uma única chamada |
| Upload para CC (início) | asset_initialize_file_upload | Primeira chamada no pipeline de upload em bloco |
| Upload para CC (fim) | asset_finalize_file_upload | Segunda chamada; retorna URL CC presigned para o quadro |
| Criar quadro Firefly | create_firefly_board | Passar import_adobe_storage com URL finalizada |
| Redimensionar vídeo | video_resize | Retorna statusId para polling |
| Polling de redimensionamento de vídeo | resizeVideoPoll | Ferramenta 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 IMAGEMvideo/*→ FLUXO DE TRABALHO DE VÍDEO
Etapa 4 — Resolver Dimensões Alvo
| O usuário diz | Resolver para |
|---|---|
1920×1080, 1920x1080 | largura: 1920, altura: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
Impressão A4 | 2480 × 3508 (300 DPI retrato) |
Impressão Carta | 2550 × 3300 (300 DPI retrato) |
16:9, 1:1, 4:5, 9:16 | string de proporção → passar como output: "16:9" |
quadrado | output: "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:
presignedAssetUrldeasset_add_file()✅outputUrlde uma chamada de ferramenta anterior ✅- URL HTTPS pública fornecida pelo usuário ✅
Não utilizáveis como imageURI:
- Caminhos
/mnt/user-data/uploads/❌ renditionURLdeasset_searchdiretamente ❌- URIs
file://❌
| Fonte | Resolução |
|---|---|
| Arquivo enviado | asset_add_file() → presignedAssetUrl |
| Ativo do armazenamento CC | asset_search → reencenar via asset_add_file() → presignedAssetUrl |
| Saída de ferramenta anterior | Usar outputUrl diretamente |
| Arquivo PSD / AI | document_render_vector (JPEG, 300 DPI) → outputPresignedUrl |
Etapa 6 (Imagem) — Modo de Ajuste
| Intenção | Modo | Observações |
|---|---|---|
| "redimensionar para LxA" / padrão | reframe | Maior corte na proporção alvo, centralizado — sem distorção |
| "sem corte", "letterbox", "ajustar dentro" | pad | Preenche espaço vazio com branco |
| "isolar assunto", "corte apertado" | extract | Corte 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 omitaoutput.
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:
- Chame
asset_add_file()para cada arquivo para obter URLs presigned individuais - Chame
image_crop_and_resizepara cada um com os mesmos parâmetros - Colete todos os valores
outputUrl - Chame
asset_preview_filecom 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_storagecom URLs presigned deasset_finalize_file_uploadpreenche quadros com sucesso.❌ Não funciona:
import_generic_assetscom 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.
| Fonte | Como |
|---|---|
Envio via asset_add_file | Usar assetId retornado |
| Armazenamento CC | asset_search com filters.mediaType: "video/mp4" → usar id do ativo |
Etapa 6 (Vídeo) — Alvos Comuns
| Nome | Dimensões |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| Vertical 9:16 | 1080 × 1920 |
| Quadrado 1:1 | 1080 × 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 diz | Valor API | Comportamento |
|---|---|---|
| "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
- Sempre chame
adobe_mandatory_initprimeiro. Todas as ferramentas Adobe dependem disso. - Nunca passe caminhos de arquivo locais para ferramentas de redimensionamento. Use
asset_add_file(). - 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.
- Lotes grandes (>20) podem exigir paginação entre turnos. Reconheça, peça ao usuário para "continuar" e retome do ponto onde parou.
- Se a criação do quadro Firefly falhar, apenas omita o link. Tentar novamente não ajuda.
- 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_vectorprimeiro. - 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
| Problema | Causa provável | Solução |
|---|---|---|
asset_add_file retorna erro | Caminho de arquivo inválido ou ausente | Certifique-se de que o arquivo existe e tente novamente |
image_crop_and_resize falha | imageURI inacessível | Use presignedAssetUrl de asset_add_file |
video_resize trava em "pending" | Ferramenta de polling não carregada | Carregue resizeVideoPoll antes de fazer polling |
| Quadro Firefly vazio | import_generic_assets não funciona | Use import_adobe_storage com URLs presigned |
| Lote grande para no meio | Contexto da conversa cheio | Peça ao usuário para "continuar" e retome |