Communitygithub.com

magic-hour-image-to-video

Anime um retrato, personagem, obra de arte ou cena com o Magic Hour, editando e inspecionando o quadro inicial quando necessário antes do movimento. Use para transformação de imagem em vídeo, transformações, revelações e animação de personagens quando o Magic Hour for solicitado ou for o provedor de mídia escolhido no projeto.

O que é magic-hour-image-to-video?

Esta skill permite gerar vídeos curtos e utilizáveis a partir de uma imagem estática, priorizando primeiro a resolução da aparência no quadro inicial e depois o movimento. Ela é especialmente útil para animação de personagens, transformações de produtos, revelações de cenas e efeitos de câmera, suportando qualquer plataforma que implemente o protocolo MCP do Magic Hour (como Claude Code, Cursor, Codex). O fluxo de trabalho é dividido em etapas claras: definição do plano (extraindo informações como proporção, assunto, ação e condições de falha), construção do quadro inicial (escolhendo entre editar imagem existente, gerar nova ou usar a fornecida), animação do quadro aprovado (escrevendo um prompt de movimento preciso e enviando para `image_to_video_create_video`), e inspeção final para garantir que identidade, geometria e texto permaneçam estáveis. A skill gerencia orçamentos, IDs de projetos e reutilização de resultados, evitando gastos desnecessários de créditos. Para transformações e revelações, ela referencia guias específicas como `references/transformations.md` e `references/multi-shot.md`, garantindo que cada tomada seja tratada como um trabalho independente com seu próprio quadro inicial revisado.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/magichourhq/skills/tree/main/skills/magic-hour-image-to-video

Perguntar na sua IA favorita

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

Documentação

Magic Hour imagem para vídeo

Produza um vídeo curto utilizável resolvendo primeiro a aparência em um quadro estático e depois o movimento. Um ID de projeto ou trabalho na fila está incompleto a menos que o usuário tenha solicitado apenas o envio.

A geração consome créditos do Magic Hour. Use um MCP de criação do Magic Hour conectado em https://mcp.magichour.ai/ quando disponível. Caso contrário, leia references/setup.md para a rota da API. Descubra os esquemas atuais antes de escolher um modelo, duração, resolução ou preço.

Escolha a direção do plano a partir do briefing; não pergunte a um usuário não técnico sobre campos de modelo ou um modelo de prompt de movimento. Respeite o orçamento existente. Quando as decisões criativas forem delegadas, inspecione e aceite o quadro estático você mesmo, depois continue para o vídeo, a menos que a aprovação do rascunho tenha sido solicitada. Mostre o clipe primeiro e mantenha os registros técnicos no projeto. Para transformações e revelações, leia dirigindo o momento; para histórias com várias batidas, leia direção multi-tomada.

Para um primeiro resultado ou recuperação de configuração, leia primeiro vídeo e próxima edição. Ele define a verificação da conta, o orçamento combinado, o registro de trabalho recuperável e o entregável reutilizável.

Defina o plano

Extraia ou infira:

  • proporção de entrega e resolução
  • o assunto, produto, personagem, cenário e detalhes visuais necessários
  • uma ação principal do assunto e um movimento de câmera
  • detalhes que devem permanecer fixos, especialmente identidade, geometria, embalagem, logotipo, texto, cores, roupas e fundo
  • condições de falha, como rosto distorcido, etiqueta alterada, corte indesejado ou texto ilegível

Mantenha um clipe curto em uma batida coerente. Se o usuário quiser várias tomadas, trate cada tomada como seu próprio quadro inicial revisado e trabalho de vídeo. Derive esses quadros da mesma referência de identidade aprovada, em vez de encadear edições não revisadas. Escolha um movimento que preserve o entregável: um dolly altera a escala do assunto e o espaço de cópia disponível, enquanto uma câmera fixa com movimento de luz ou ambiente restrito pode preservar um layout de herói.

Construa o quadro inicial primeiro

Escolha uma rota:

  1. Uma imagem de origem utilizável já existe: chame ai_image_editor_create_image quando composição, guarda-roupa, fundo, iluminação, posicionamento do produto ou limpeza precisarem mudar. Declare tanto a edição solicitada quanto tudo que deve permanecer inalterado.
  2. Nenhuma imagem de origem existe: chame ai_image_generator_create_image. O AI Image Editor requer uma imagem de entrada; não envie a ele uma solicitação de criação apenas com prompt.
  3. A imagem fornecida já satisfaz o plano: pule a geração de imagem e anime-a diretamente.

Crie um quadro estático na proporção de vídeo pretendida. Use uma referência autorizada quando identidade exata, geometria do produto, embalagem ou marca forem importantes. Não espere que a conversão de imagem para vídeo repare um quadro de origem ruim.

Aguarde o projeto de imagem com wait_for_image_project. Visualize o quadro estático concluído e rejeite-o antes da animação se ele tiver um corte errado, problema de anatomia, identidade alterada, produto malformado, logotipo ou texto impreciso, letras não intencionais, artefato visual ou falta de espaço negativo. Corrija o quadro estático com a menor edição útil. Uma segunda solicitação de imagem paga requer um orçamento autorizado.

Anime o quadro aprovado

Passe a saída exata da imagem aprovada para image_to_video_create_video. Se o resultado for um arquivo local, faça upload de seus bytes brutos primeiro usando o fluxo em references/setup.md; um caminho local não é um file_path hospedado.

Escreva o prompt de movimento em torno da mudança ao longo do tempo:

  • movimento do assunto, com velocidade e direção claras
  • movimento da câmera, ou declare explicitamente que a câmera está fixa
  • movimento ambiental, como tecido, vapor, cabelo, luz ou partículas
  • o que permanece fixo
  • tempo e estado final, incluindo uma exposição final mantida quando nenhum fade é desejado

Evite redescrever todo o quadro estático em nova linguagem visual. Isso convida o modelo a redesenhar o assunto. Para um plano de reação: O peixe nada lentamente ao lado do ombro dela; ela o nota e vira-se ligeiramente com um sorriso surpreso. Um lento zoom aproxima mantém o rosto dela e o peixe separados. Preserve identidade, roupas e cena. Sem cortes. Um layout de produto pode, em vez disso, precisar de um assunto fixo e área de cópia protegida. Não exija um assunto centralizado quando o quadro aprovado o coloca à direita.

Use um quadro final apenas quando o esquema atual disser que o modelo, resolução e duração escolhidos o suportam. Prefira o modelo recomendado ao vivo para uma solicitação geral. Selecione um especialista apenas quando seu esquema descrever o controle necessário. Combine resolução e duração com o entregável solicitado. Uma prévia curta testa um intervalo curto, não a estabilidade em um clipe mais longo. Verifique o custo total de imagem estática mais vídeo em relação à autorização existente e pergunte apenas quando não cobrir o trabalho pretendido.

Envie o vídeo uma vez, mantenha seu ID de projeto e chame wait_for_video_project. Um tempo limite de espera não é uma geração falhada e não justifica reenviar a chamada de criação.

Inspecione e entregue

Depois que o projeto relatar complete, use o URL de download retornado exatamente como fornecido. Verifique as dimensões baixadas, duração e presença de áudio. Assista ao clipe completo quando a reprodução estiver disponível, depois inspecione o primeiro quadro, o ponto médio, o último quadro e qualquer transição suspeita. Três quadros estáticos sozinhos não podem provar a ausência de cintilação. Verifique:

  • o primeiro quadro corresponde ao quadro estático aprovado
  • identidade, forma do produto, logotipo, texto e roupas permanecem estáveis
  • o movimento segue a direção e velocidade solicitadas
  • a câmera não se desvia ou corta inesperadamente; inspecione o quadro final real em busca de um fade indesejado ou assunto perdido, mesmo quando os diagnósticos de quadro preto estiverem limpos
  • nenhuma distorção, cintilação, derretimento, objetos duplicados ou colapso abrupto do quadro final aparece
  • qualquer áudio gerado é intencional e coerente

Se um critério obrigatório falhar, identifique-o e altere a menor entrada relevante: quadro inicial para problemas de aparência, prompt de movimento para problemas de movimento, ou modelo/resolução apenas quando o esquema ao vivo suportar o comportamento necessário. Não gaste créditos em outra tentativa fora do orçamento do usuário.

No exemplo retrato-para-koi, a identidade permaneceu reconhecível, mas uma ligeira virada solicitada tornou-se uma virada maior em ambas as direções. Mantenha o quadro estático aceito ao corrigir esse movimento. Se a tela baixada diferir ligeiramente da proporção solicitada, inspecione o caminho de ação completo antes de um corte local; não regenere uma tomada de outra forma aceita apenas para remover pixels de borda.

Retorne o vídeo finalizado ou link utilizável, o local salvo quando aplicável, os IDs do projeto de imagem e vídeo, e qualquer limitação material.

Habilidades Relacionadas