Um catálogo de fotos de produto é longo demais para animar à mão. Uma API de imagem para vídeo deixa o seu próprio código fazer a parte repetitiva: você envia uma foto e uma breve descrição do movimento, um modelo de vídeo devolve um clipe e um script repete isso para cada linha da sua planilha. A API do Picasso IA funciona assim, com uma chave da sua conta e os mesmos modelos que você pode testar hoje no toolkit.
A maioria das lojas já tem a parte difícil pronta: uma foto limpa de cada item. O que falta é movimento, porque páginas de produto, anúncios sociais e listagens de marketplaces pedem cada vez mais um clipe curto, e ninguém tem tempo de abrir um aplicativo web e subir a foto número 400. Para dez itens, o navegador resolve. Para um catálogo, isso é um laço, e laços pertencem ao código.
Com a API você cria uma chave na sua conta, envia uma requisição por geração que nomeia um modelo e suas entradas, e o resultado volta como um arquivo que você pode baixar. O lado de vídeo do catálogo é grande: 121 dos 502 modelos estão na categoria de texto para vídeo, e vários deles aceitam uma foto inicial. Você pode explorá-los no catálogo completo. O toolkit roda hoje os mesmos modelos, então você pode testar qualquer foto e qualquer modelo lá antes de escrever uma linha de código, e as mesmas escolhas passam para o seu script.
Modelos de imagem para vídeo não se comportam do mesmo jeito. Alguns fixam exatamente o primeiro e o último quadro, outros adicionam som, e alguns funcionam melhor com um giro lento de produto do que com uma pessoa andando por uma cena. Passe a mesma foto por dois ou três no toolkit, fique com o que respeita o seu produto e escreva essa escolha no seu script.
| Modelo | O que faz com a sua foto | Use quando |
|---|
| wan-2.7-i2v | Anima uma foto, pode fixar o primeiro e o último quadro, aceita um arquivo de áudio | Você quer um giro limpo que começa e termina no enquadramento exato |
| kling-v3-video | Parte de uma foto, pode fixar uma imagem final, som gerado opcional, clipes mais longos | Algo em uma cena de estilo de vida precisa se mover |
| ray-3.2 | Foto como quadro inicial ou final, opção de loop, saída HDR | Um fundo em loop para uma página de produto |
| veo-3.1 | Foto como ponto de partida, imagens de referência para manter um sujeito consistente, som ativado por padrão | Um produto colocado em um cenário com áudio ambiente |
As configurações mudam de modelo para modelo, incluindo duração do clipe, resolução e proporção, e a lista muda conforme novos modelos entram. Consulte a página do modelo no catálogo para ver o que cada um aceita, em vez de supor que combina com outro.
Teste primeiro uma foto no toolkit e depois leve as mesmas escolhas para o código. O caminho pela API é curto, e cada passo fica no nível do que você faria à mão.
- Crie uma chave na sua conta. A chave identifica você e gasta os seus créditos, então trate como uma senha e mantenha fora de repositórios compartilhados e do código do navegador.
- Escolha um modelo e prepare a foto. Pegue um entre wan-2.7-i2v, kling-v3-video, ray-3.2 ou veo-3.1 depois de testar no toolkit, e use o original limpo da foto, não uma cópia comprimida.
- Envie uma requisição por geração. Cada requisição nomeia o modelo, anexa a foto e leva um prompt curto sobre o movimento; seu script repete isso para cada item do catálogo.
- Baixe o arquivo quando estiver pronto. Um vídeo leva tempo para ser gerado, então seu código espera o resultado e salva o clipe junto do item de onde ele veio.
- Revise cada clipe antes de publicar. Assista a cada um procurando rótulos tortos, cores trocadas e detalhes inventados, e publique só os clipes que ainda mostram o produto real.
A foto já diz como o produto é, então o prompt deve dizer apenas o que se move. Descreva um movimento de câmera e, no máximo, outra mudança: uma órbita lenta ao redor da garrafa, vapor subindo da xícara, um tecido se levantando com uma brisa leve. Prompts longos convidam o modelo a improvisar, e improvisar é como uma jaqueta de três botões ganha um quarto.
Escreva o prompt como um modelo com um espaço para o item: o nome do produto, uma frase de movimento e uma de iluminação. Mantenha a mesma frase de movimento em toda a categoria, para que todas as xícaras se movam como xícaras e você note a que destoa num relance.
Reaproveite uma única redação para a categoria inteira e troque apenas o nome do produto. Quando um clipe sair errado, você sabe que é a foto ou o modelo, e não um prompt que você reescreveu no meio do lote.
Fixe o quadro final quando o modelo permitir e o clipe precisar terminar na foto limpa do produto. Peça que não haja texto sobre o produto, porque as letras são justamente o que esses modelos deformam primeiro.
A escolha da foto importa tanto quanto o prompt. Uma imagem nítida, com luz uniforme e fundo liso deixa menos coisas para o modelo adivinhar, enquanto uma cena carregada, com reflexos, dá muita margem. Enquadre para que o produto ocupe quase todo o quadro, deixe as bordas livres de mãos e acessórios e evite fotos em que um rótulo fica meio escondido: o que o modelo não vê, ele inventa.
Um lote é o seu laço mais um pouco de controle. Leia a lista de fotos, envie uma requisição por item, salve cada arquivo devolvido com o identificador do próprio item e anote qual modelo e qual prompt o geraram. Esse registro é o que permite regenerar um clipe no mês que vem sem refazer o resto.
Comece com uma amostra pequena de produtos que cubra os seus casos mais difíceis: superfícies brilhantes, alças finas, qualquer coisa com texto impresso. Revise esses clipes, ajuste o modelo de prompt e só então deixe o laço rodar com tudo. Cada geração custa créditos que dependem do modelo e das configurações, então uma rodada de teste também é a forma mais barata de saber quanto uma rodada completa vai gastar; a página de preços é onde ficam os planos.
Se o que você precisa de verdade é um punhado de clipes para anúncios e não um pipeline, o passo a passo de vídeos de demonstração de produto e a página sobre transformar fotos em vídeos cobrem os mesmos modelos sem uma linha de código.
Um script elimina a digitação, não o julgamento. Cinco pontos em que ele deixa de ajudar:
- Gerar leva tempo e custa créditos: um clipe não é instantâneo, um catálogo são muitos clipes, e um laço com um prompt ruim gasta créditos em cada resultado ruim.
- Os modelos diferem: a mesma foto pode voltar fiel com um modelo e distorcida com outro, e um prompt ajustado para um raramente serve igual em outro.
- Os detalhes do produto se deslocam: logotipos, texto impresso, botões pequenos e padrões finos podem deformar ou mudar durante o movimento, e isso pesa quando o comprador espera o item da foto.
- Todo resultado precisa de revisão: nada no pipeline distingue um clipe fiel de um enganoso, então uma pessoa precisa assistir a cada clipe antes de publicar.
- Os direitos vêm primeiro: você precisa ter o direito de animar cada foto, e o clipe deve continuar verdadeiro sobre o item, porque um vídeo que faz o produto parecer diferente do que é enviado convida devoluções e reclamações.
As plataformas também definem suas próprias regras de duração, formato e divulgação de vídeo. Confira os requisitos atuais de cada marketplace ou rede de anúncios antes de subir um lote.
O que é uma API de imagem para vídeo?
É uma forma de pedir um vídeo por código em vez de por uma página web. Seu script envia uma foto, o nome de um modelo e um prompt curto, e o clipe gerado volta como um arquivo. Na prática é o mesmo trabalho que você faz no toolkit, repetido automaticamente, e isso a torna útil para um catálogo com centenas de itens.
Preciso de uma chave para usar?
Sim. Você cria uma chave na sua conta, e ela liga cada requisição a você e aos seus créditos. Trate como uma senha: não cole em um repositório público, em um documento compartilhado nem em código que roda no navegador de um visitante. Se achar que vazou, crie uma nova e pare de usar a antiga.
Quais modelos conseguem animar uma foto de produto?
Vários do catálogo aceitam uma foto inicial. Os que esta página destaca são kling-v3-video, wan-2.7-i2v, ray-3.2 e veo-3.1, e eles se diferenciam em como tratam o primeiro e o último quadro, o som, os loops e a duração do clipe. A categoria de vídeo reúne 121 modelos no total, então teste dois ou três com as suas próprias fotos antes de escolher um.
Posso testar antes de escrever código?
Pode, e essa é a ordem sensata. O toolkit roda hoje o mesmo catálogo: você escolhe um modelo, anexa uma foto de produto, escreve um prompt curto e gera. Quando um modelo e um prompt mantêm o seu produto fiel, você sabe exatamente o que o seu script deve enviar. Contas novas ganham créditos grátis, o bastante para comparar alguns modelos em algumas fotos.
Quanto custa?
As gerações são pagas com créditos, e o custo depende do modelo e das configurações que você escolhe, então não existe um preço único por clipe. Vídeo custa mais do que uma imagem estática. Veja a página de preços para conhecer os planos, e rode antes uma amostra pequena com as suas fotos para saber quanto um catálogo completo gastaria antes de iniciar o laço.
Posso animar um catálogo inteiro de uma vez?
Você envia uma requisição por geração, então um catálogo é um laço no seu código, uma requisição por foto. Isso mantém cada clipe separado, o que ajuda porque um resultado que falhou ou ficou fraco afeta só aquele item. Faça primeiro uma amostra pequena, revise os clipes, rode o resto e guarde um registro do modelo e do prompt usados em cada arquivo.
Quanto tempo leva para gerar um clipe?
Mais do que uma imagem, e varia conforme o modelo e as configurações, então nenhum número honesto serve para todos os casos. Seu código deve esperar cada resultado em vez de supor que já está pronto, e não deve depender de todos os clipes terminarem juntos. Planeje os lotes como um trabalho que roda em segundo plano e é recolhido depois.
Tenho o direito de animar uma foto?
Só se a foto for sua para usar. Fotos que você tirou ou encomendou não dão problema; imagens de fornecedores, listagens de marketplaces e qualquer coisa de um banco de imagens dependem da licença, então leia antes. Evite fotos com uma pessoa real e identificável, a menos que tenha a permissão dela, e mantenha a animação verdadeira em relação ao item que você vende.
O produto no vídeo vai ficar exatamente como na minha foto?
Nem sempre. Os modelos inventam movimento, e movimento inventado pode entortar um logotipo, mudar uma cor ou acrescentar um detalhe que o item não tem. Por isso cada clipe precisa de revisão antes de ir ao ar. Prompts curtos que descrevem só o movimento, junto com um quadro final fixado quando o modelo permite, reduzem o desvio, mas não o eliminam.
O que fazer se uma requisição falhar ou eu tiver uma dúvida?
Confira primeiro a página do modelo no catálogo, porque cada modelo aceita entradas diferentes e uma requisição que serve para um pode ser recusada por outro. Se isso não resolver, fale com o suporte e descreva o modelo, a foto e o que voltou. Testar a mesma foto no toolkit costuma mostrar se o problema está na entrada ou na requisição.
Pronto para ver o seu próprio produto se mover? Abra o toolkit, passe uma foto por um modelo e use o que aprender como modelo para o seu script.