Seus usuários já sabem o que é um clipe curto. O que eles não têm é um jeito de fazer um dentro do seu app sem pular para outra aba e voltar com um arquivo. Com a API da Picasso IA, seu app envia uma requisição por geração, nomeando um modelo de vídeo e suas entradas, e o clipe pronto volta como um arquivo que você pode mostrar, guardar e revisar. A requisição é a parte fácil. O trabalho de verdade está no produto ao redor dela: a espera, os créditos, a moderação, o armazenamento e os direitos.
Uma função de vídeo muda para que serve o seu produto. Um app de cartões que anima o cartão, um diário de viagem que transforma uma foto em um cartão-postal em movimento, uma ferramenta de jogos que cria uma vinheta curta para um personagem, um painel de loja que prepara o rascunho de um clipe de produto: em todos os casos o usuário fica onde o trabalho dele já mora, em vez de exportar, converter e importar.
O outro motivo é a escolha. O catálogo da Picasso IA tem 502 modelos, 121 deles na categoria de texto para vídeo e outros 28 em edição de vídeo. Para quem constrói, isso importa, porque nenhum modelo de vídeo é o melhor em tudo. Um lida bem com uma pessoa, outro segue de perto uma instrução de câmera, outro é a opção mais barata para um rascunho. A API foi pensada para chegar ao mesmo catálogo do toolkit e ao mesmo sistema de créditos, então você não prende sua função aos hábitos de um único motor.
O enquadramento honesto: isso é um jeito de oferecer geração, não de garantir resultados. Cada clipe que seus usuários criam é um modelo interpretando um prompt, e seu produto precisa ser desenhado em torno desse fato, não apesar dele.
Antes de qualquer arquitetura, anote as três ou quatro coisas que uma pessoa faz na sua função. A maioria das funções de vídeo se reduz ao mesmo conjunto pequeno de ações, e nomeá-las cedo mantém a interface honesta.
A primeira é texto para vídeo: o usuário descreve uma cena e um movimento em uma ou duas frases e recebe um clipe. A segunda é imagem para vídeo: ele anexa uma imagem dele, como uma foto de produto, um desenho ou um retrato de si mesmo, e pede que se mova. A terceira é a nova tentativa: o primeiro clipe chega perto mas erra, então ele troca uma palavra e gera de novo. A quarta, se o seu produto precisar, é uma edição pequena depois, como cortar, ampliar ou adicionar som, que outros modelos do catálogo cobrem. Para ver como funciona a segunda ação, transformar fotos em vídeos mostra o caminho no toolkit.
Nada dessa lista exige que o usuário saiba qual modelo rodou. Você pode oferecer um seletor ou escolher por ele.
Cinco preocupações decidem se uma função de vídeo parece sólida ou frustrante. Nenhuma é um problema de programação e todas têm uma versão que o usuário enxerga. Esta tabela é a folha de planejamento: o que o usuário vive e a decisão que cabe a você.
| Preocupação | O que seu usuário vive | A decisão que é sua |
|---|
| Tempo de espera | Um clipe não é instantâneo, então a tela precisa de um estado para isso | Mostrar progresso, deixar a pessoa sair e voltar, ou avisá-la |
| Créditos | Cada geração custa créditos que dependem do modelo e das configurações | Repassar o custo, absorvê-lo ou limitar quantos clipes uma pessoa pode fazer |
| Moderação | Alguns prompts ou imagens nunca deveriam virar um clipe | Filtrar entradas, revisar saídas e decidir o que uma denúncia faz |
| Armazenamento | O arquivo devolvido precisa morar onde a pessoa consiga achá-lo de novo | Onde fica guardado, por quanto tempo e quem pode apagar |
| Direitos | O clipe pode mostrar um rosto, uma voz ou um design que pertence a alguém | Exigir que enviem apenas material próprio ou sujeitos fictícios |
O tempo de espera merece a maior atenção de design, porque é o que o usuário sente. Gerar leva tempo de verdade e varia com o modelo e as configurações, então construa para uma faixa e não para um número. Quem pode continuar usando seu app enquanto um clipe é gerado perdoa uma espera longa.
Os créditos são a outra questão silenciosa. O custo vem do modelo e das configurações escolhidas, e a página de preços é onde ficam os planos. Decida cedo se seus usuários veem os créditos, porque isso muda sua interface: um app que gasta seus créditos em nome deles precisa de limites, e um que repassa precisa de um preço claro antes do clique.
Regra de design: trate o clipe como um resultado que chega depois, não como uma resposta que você espera. Se a sua tela só funciona quando a resposta é rápida, ela vai falhar na primeira vez que um modelo estiver lento.
Você pode rodar quase todo este ciclo hoje sem escrever nada, porque o toolkit roda o mesmo catálogo que a API foi pensada para expor. Use-o para decidir o que sua função deve pedir aos usuários e depois replique o mesmo formato no seu app.
- Teste o prompt no toolkit. Abra o toolkit, escolha um modelo de vídeo como veo-3.1 ou kling-v3-video e escreva o tipo exato de prompt que seus usuários escreveriam, inclusive os ruins.
- Crie uma chave na sua conta. A API funciona com uma chave que você cria na sua conta. Trate-a como uma senha: guarde no seu servidor, nunca dentro de um app que as pessoas baixam nem numa página que possam inspecionar.
- Envie uma requisição por clipe. Seu servidor nomeia o modelo e as entradas, um prompt e, nos modelos que animam uma imagem, uma imagem. Seu app avisa o usuário na hora de que o clipe está sendo feito.
- Espere e pegue o arquivo. O resultado volta como um arquivo que você pode baixar. Passe-o pela sua etapa de revisão e guarde onde o usuário possa encontrá-lo de novo.
- Mostre o clipe e conte os créditos. Coloque o clipe na biblioteca do usuário, registre quanto a geração custou e confira os totais com o plano da sua conta.
Faça o passo um com uma dúzia de prompts reais antes do passo três. Os prompts que um desconhecido escreve são de onde saem suas decisões de moderação.
Você não precisa se fixar em um único modelo para a função toda. Pense em papéis, teste alguns no toolkit e escolha por caso de uso. São modelos que existem hoje no catálogo, todos na categoria de texto para vídeo, que também inclui as variantes de imagem para vídeo.
Para um resultado premium num momento de destaque, comece com veo-3.1 do google ou kling-v3-video do kwaivgi. Para clipes curtos e divertidos, vale rodar seedance-2.0 da bytedance e hailuo-2.3 da minimax. wan-3 da alibaba e sora-2 da openai completam uma primeira comparação, e ltx-2.3-fast da lightricks é o nome para testar quando você quer ver como um modelo mais leve se comporta em rascunhos.
Não leia isso como um ranking. Passe os mesmos três prompts por cada um, olhe rostos, mãos, movimento e o quanto o prompt foi seguido, e anote qual modelo vence em cada trabalho. Se o seu produto transforma imagens estáticas em clipes, a página de vídeos de demonstração de produto com IA mostra o que uma foto de produto precisa para sobreviver à animação. Explore a lista completa em o catálogo antes de fechar sua seleção.
Uma API de geração entrega clipes. Ela não entrega um produto de vídeo. Estes são os limites para planejar, para que nenhum chegue de surpresa depois do lançamento.
- Tempo: cada clipe demora para ser gerado e o tempo depende do modelo e das configurações. Sua interface precisa de um estado de espera, de um jeito de voltar depois e de um plano para uma requisição que falha.
- Custo: cada geração gasta créditos e modelos mais pesados gastam mais. Uma função sem limites pode queimar créditos mais rápido do que você espera, então decida tetos antes que o primeiro usuário o faça.
- Variação: os modelos diferem, e o mesmo prompt dá resultados diferentes em motores diferentes, e até em tentativas diferentes. Você não pode prometer um clipe específico, só uma tentativa.
- Revisão: as saídas podem trazer mãos estranhas, texto derretido ou um rosto que muda. Alguém, ou alguma regra, precisa olhar os clipes antes de eles aparecerem onde outras pessoas veem.
- Direitos: o arquivo que você recebe não resolve de quem é o que ele mostra. Seus termos devem dizer que os usuários enviam apenas material próprio ou sujeitos fictícios, nunca a imagem de uma pessoa real sem consentimento.
Nada disso é argumento contra a função. É argumento a favor de delimitá-la: clipes curtos, um estado de espera claro, créditos visíveis e uma etapa de revisão. Uma função pequena que se comporta de forma previsível vence uma grande que surpreende as pessoas.
Meus usuários conseguem gerar vídeo sem sair do meu app?
Esse é o propósito da API da Picasso IA. Seu servidor envia uma requisição por clipe, nomeando um modelo e suas entradas, e o resultado volta como um arquivo que você pode baixar e mostrar nas suas próprias telas. Seus usuários nunca veem outro site. O que eles vão notar é a espera, porque um clipe leva tempo para ser gerado, então a experiência depende de um bom estado de progresso mais do que de qualquer outra coisa que você construa.
Preciso de uma chave de API e como devo tratá-la?
Sim. O acesso funciona com uma chave que você cria na sua conta, e ela deve ser tratada como uma senha. Guarde no seu servidor, carregue de um cofre de segredos ou de uma variável de ambiente e nunca coloque em um app móvel, em um pacote do navegador nem em um repositório público. Se achar que vazou, troque-a pela sua conta e atualize seu servidor. Seus usuários nunca precisam vê-la.
Quais modelos posso oferecer em uma função de vídeo?
O catálogo tem 121 modelos de texto para vídeo e 28 de edição de vídeo, de 502 no total, e o toolkit roda todos hoje. Entre os nomes para testar primeiro estão veo-3.1, kling-v3-video, seedance-2.0, hailuo-2.3, wan-3 e sora-2. Veja a página de cada modelo para saber o que ele aceita, porque alguns recebem só um prompt e outros podem partir de uma imagem. Passe seus próprios prompts pelo toolkit antes de escolher.
Quanto meus usuários vão esperar por um clipe?
Depende do modelo, da duração e das configurações, então esta página não cita número nenhum. Planeje para uma faixa: alguns clipes voltam rápido e outros demoram bem mais. O desenho seguro é confirmar a requisição na hora, mostrar que há trabalho em andamento, deixar a pessoa continuar usando seu app e avisá-la quando o arquivo estiver pronto. Teste os modelos que escolher no toolkit para sentir as esperas reais.
Como funcionam os créditos quando meus usuários geram clipes?
Gerar custa créditos e a quantidade depende do modelo e das configurações escolhidas. A API foi pensada para usar o mesmo sistema de créditos do toolkit, então o que você vê lá é o que deve esperar. Os planos e suas franquias ficam na página de preços, e contas novas ganham créditos grátis para testar. Você decide se absorve o custo, repassa aos seus usuários ou limita quantos clipes cada pessoa pode fazer.
O que devo moderar em uma função de vídeo?
Em dois lugares: o que entra e o que sai. Nas entradas, decida quais prompts e imagens enviadas você recusa, como imagens de pessoas reais que não aceitaram aparecer. Nas saídas, revise os clipes antes de compartilhá-los publicamente, porque os modelos podem produzir resultados estranhos ou indesejados. Dê aos usuários um jeito de denunciar um clipe e decida o que acontece depois. Seus próprios termos de uso devem dizer tudo isso com clareza.
Onde devo guardar os clipes gerados?
O resultado volta como um arquivo que você pode baixar, então guardá-lo é com você. Salve em um armazenamento que você controla, ligado ao usuário que pediu, e decida por quanto tempo fica e quem pode apagar. Não conte com o arquivo devolvido continuando disponível para sempre. Se os clipes puderem ser compartilhados, planeje as regras de acesso desde o começo.
De quem são os clipes que meus usuários geram?
Confira duas coisas. Primeiro, os direitos da entrada: um usuário que envia a foto do próprio produto está numa posição diferente de quem envia a arte de outra pessoa, e o gerador não muda de quem é o que uma imagem mostra. Segundo, os termos do seu plano para as saídas. Coloque suas próprias regras diante dos usuários e peça que uma pessoa qualificada as revise se os clipes forem vendidos ou publicados com fins comerciais.
Os usuários podem animar fotos de si mesmos ou de outras pessoas?
Só de si mesmos, de alguém que tenha concordado claramente ou de um personagem fictício. Nunca de uma pessoa real identificável sem consentimento, e nunca a foto de um menor enviada por outra pessoa. Coloque isso na sua tela de envio com uma linha curta e clara, e nos seus termos. Uma regra clara vence um filtro engenhoso.
E se um clipe sair errado ou uma requisição falhar?
Planeje para os dois casos. Clipes errados são normais: deixe os usuários editarem o prompt e tentarem de novo, e mostre o custo em créditos de uma nova tentativa antes de apertarem o botão. Requisições que falham precisam de uma mensagem clara e de um jeito de tentar de novo. Se algo parecer quebrado do seu lado ou você tiver uma dúvida sobre sua conta, o suporte é o caminho direto até uma pessoa.
Um bom jeito de começar é testar os clipes que seus usuários pediriam. Abra o toolkit, passe alguns prompts reais por dois ou três modelos de vídeo e anote o que sua função precisa prometer.