Usa a edição de vídeo do Kling 4.0 quando quiseres modificar material existente e pedir ao modelo que mantenha a ação, o ritmo, o enquadramento ou o sujeito. O pedido deve identificar o que muda e o que fica. Um vídeo de referência usado para inspirar uma nova geração é um fluxo diferente de um vídeo de origem que está a ser editado.
Este guia usa a API do Kling 4.0 no PoYo e um exemplo concluído e guardado do PoYo: uma raposa vermelha a caminhar na neve, editada para um bosque de outono. É um exemplo de mudança de cenário, não uma prova de que qualquer substituição de produto ou edição com preservação de identidade resultará.
Vê o original e o resultado editado
Original: plano de vida selvagem em pleno inverno. Tarefa gravada 9DRXDJ5XGW41B9IW, cinco segundos pedidos em 720p, gerada a partir de um primeiro frame. Custo registado: 142,5 créditos.
Resultado editado: bosque de outono. Tarefa gravada 84PEDOWZ40C5D7VM, cinco segundos pedidos em 720p, com o vídeo de origem e uma imagem de referência de outono. Custo registado: 187 créditos.
Transfere o pedido de edição exato e os metadados do exemplo. Compara diretamente os clipes original e editado: as marcas da raposa, o andar, o movimento da cabeça, o contacto com o chão, o travelling da câmara e os limites da folhagem, tudo isto conta. Um fundo alterado não basta se a ação de que precisavas se tiver desviado.
Escolhe a edição de forma explícita com video_url
O template abreviado seguinte demonstra os campos; o ficheiro para transferir contém o prompt completo da tarefa gravada.
{
"model": "kling-4.0",
"input": {
"video_url": "https://storage.poyo.ai/blog/kling-4-0-series-20261024/fox-video-d0100387a0e0.mp4",
"reference_image_urls": ["https://storage.poyo.ai/blog/kling-4-0-series-20261024/autumn-reference-0773c88cbeb3.png"],
"prompt": "Edit @Video1 into the autumn woodland shown in @Image1. Replace snow with dry fallen leaves and distant conifers with silver birches. Preserve the same fox, its markings, proportions, walking and head movements, timing, framing and camera tracking. Match shadows and light to the new environment. Return one coherent live-action scene, not a montage or transition.",
"duration": 5,
"resolution": "720p"
}
}
A origem é referida como @Video1; a referência de imagem é @Image1. As imagens especificam o novo aspeto, enquanto a origem fornece o movimento a preservar. O video_url seleciona a edição com prioridade sobre os modos de geração, por isso não o acrescentes a um pedido que deva gerar um plano novo a partir de uma referência de movimento.
O que o esquema de edição do PoYo aceita
A origem tem de durar entre 3 e 30 segundos reais. A edição exige prompt e suporta 720p ou 1080p. Pode usar imagens de referência e sujeitos definidos por imagens, mas rejeita image_urls, reference_video_urls, sujeitos definidos por vídeo, multi_prompt e aspect_ratio.
Não envies campos não suportados com valores null ou vazios para tentares desativá-los. Omite-os. A interface de edição atual do PoYo aceita um único campo de vídeo de origem; o fluxo com vários vídeos do produto para criadores, mais abrangente, não é motivo para inventares aqui um array video_urls. Verifica a documentação atual da API para ver as atualizações.
Como escrever um prompt de edição restrito
Separa a instrução em duas afirmações claras. Primeiro, nomeia a alteração pretendida: trocar a estação do ano, mudar um casaco ou substituir um produto. Segundo, nomeia a estrutura que se mantém: identidade do sujeito, ritmo da ação, movimento de câmara, enquadramento e objetos intocados.
Na substituição de produtos, fornece uma referência limpa com uma silhueta nítida e escreve que objeto deve ser substituído. Verifica o contacto com as mãos e as superfícies, as oclusões em movimento, as sombras e os reflexos. O modelo pode alterar mais do que pediste, por isso compara o plano inteiro e verifica os pormenores da marca antes de aprovares. O exemplo da raposa deste artigo não demonstra uma taxa medida de sucesso na substituição de produtos.
Evita alterar a personagem, o fundo, o vestuário, a câmara e o diálogo no mesmo primeiro teste. Se uma edição falhar, uma alteração mais pequena torna o diagnóstico seguinte mais útil.
Estima o custo a partir da duração da origem e da saída
A edição usa o preço de entrada de vídeo. À tarifa de tabela atual do PoYo, 720p custa 17 créditos por segundo faturado e 1080p custa 25,5. Os segundos faturáveis são output + max(ceil(source duration), output).
Para uma origem de exatamente cinco segundos e uma saída pedida de cinco segundos, a estimativa é de 10 segundos faturados: 170 créditos / $0.85 em 720p. Os ficheiros reais podem durar ligeiramente mais do que a duração de geração pedida. O custo registado de 187 créditos da tarefa de outono guardada corresponde a 11 segundos faturados; usa a duração da origem medida pelo servidor e os registos das tarefas, em vez de assumires que todos os ficheiros de “cinco segundos” têm exatamente cinco segundos.
Quando duration é omitido, o PoYo usa o arredondamento por excesso da duração da origem para a faturação da saída, deixando a duração omitida no pedido enviado ao fornecedor original. Consulta o guia de preços para ver exemplos com durações fracionárias.
Revê antes de publicar
Vê os dois clipes em pontos equivalentes e depois à velocidade normal. Verifica a identidade dos objetos, a continuidade do movimento, a cintilação nos contornos, a estabilidade das texturas e qualquer conteúdo não intencional. Ouve a banda sonora completa como uma verificação à parte; manter o visual não significa manter o áudio.
Para uma geração nova com referências, usa o guia do Omni Reference. Para a submissão e a consulta, usa o tutorial da API. O guia oficial para criadores oferece fluxos criativos adicionais, sujeitos à disponibilidade da plataforma.