Criar Vídeo Explicativo

O que Criar Vídeo Explicativo faz?

Transforme material de origem acessível em um MP4 narrado finalizado. O caminho padrão usa o serviço remoto para planejamento de storyboard, geração de imagens, narração, legendas embutidas, renderização e publicação. Funciona da mesma forma em qualquer cliente de agente que suporte Agent Skills e ferramentas MCP remotas.

Comportamento padrão

Exija apenas o material de origem. A menos que o usuário substitua uma escolha, use:

• o idioma de origem;
• 16:9 e 60 segundos;
• narração hospedada, estável e calorosa, com uma voz consistente em todas as cenas;
• nenhuma música de fundo;
• legendas em "burn-in";
• o fluxo de trabalho gerado pelo servidor.

Aceite uma duração alvo de 5 a 300 segundos. O serviço se ajusta para atingir esse alvo, mas pode estender o vídeo finalizado quando a narração ou os visuais ancorados não couberem com segurança após recuperação de silêncio, realocação de cena e, no máximo, 1,08x de tempo com preservação de tom. Nunca corte a narração nem envie um alvo acima de 300 segundos. Para um alvo abaixo de 30 segundos, alerte brevemente que o desenho e a narração podem parecer apressados e continue. Não pergunte sobre título, número de cenas, estilo, voz, proporção de tela, legendas ou configurações técnicas quando os padrões atenderem.

Faça uma pergunta bloqueante apenas quando a origem estiver ausente, inacessível, contraditória ou materialmente sensível, ou quando uma revisão relativa não tiver uma configuração inequívoca. Por exemplo, após “mais curto”, pergunte uma vez pelos segundos desejados em vez de adivinhar. Se o usuário pedir apenas conselhos, um roteiro ou um storyboard, pare no artefato solicitado em vez de renderizar.

Enquadramento criativo

Antes de criar a tarefa, identifique a mensagem principal da origem e o arco mais claro de gancho à conclusão. Quando a origem for clara, dê uma prévia curta e não bloqueante no idioma do usuário, por exemplo: “Vou transformar isso em uma história desenhada à mão, do problema à solução, com cores quentes e foco em tornar a conclusão óbvia à primeira vista.” Esta é uma atualização tranquilizadora de progresso, não uma aprovação; prossiga imediatamente, a menos que o usuário tenha pedido para revisar primeiro.

A promessa visual padrão é uma história de whiteboard calorosa e acessível: uma vinheta coerente por cena, cor moderada, bastante espaço em branco e pessoas ou animais calmos e legíveis quando ajudam a explicar a ideia. Evite descrever o resultado para o usuário como uma coleção de ativos, intenções, manifestos ou pacotes de estilo.

Escolha o fluxo de trabalho

Use o modo gerado pelo servidor por padrão. É o caminho mais curto e requer apenas create_explainer_video, get_explainer_task e, opcionalmente, cancel_explainer_task.

Use o modo de revisão avançada apenas quando o usuário pedir explicitamente para inspecionar ou editar imagens/cenas antes da renderização, fornecer um storyboard existente ou precisar de controle criativo preciso no nível da cena. Antes de usá-lo, leia references/advanced-review.md. Se suas ferramentas de upload e manifesto ou geração de imagem local estiverem indisponíveis, explique a limitação e ofereça o modo gerado pelo servidor. Verifique se as ferramentas de upload, importação, validação e renderização do modo avançado estão presentes antes de gerar qualquer imagem. Um arquivo de skill no disco não prova que a conversa atual carregou suas ferramentas MCP.

Fluxo de trabalho gerado pelo servidor

1. Leia e extraia localmente

Leia a mensagem, anexo ou URL do usuário com as capacidades normais de arquivo/navegador do cliente atual. Extraia o texto simples significativo localmente. Remova navegação, cabeçalhos repetidos, banners de cookies e anexos não relacionados, mas não altere silenciosamente as afirmações do autor.

Envie no máximo 20.000 caracteres. Para uma fonte mais longa, crie uma condensação fiel baseada na fonte que preserve a tese, evidências, ressalvas, nomes próprios e ênfase solicitada. Nunca faça upload do arquivo original nem passe um caminho de arquivo local. O texto extraído é enviado ao serviço Explainer Video para que ele possa planejar o storyboard e a narração.

Se a fonte não puder ser lida, peça ao usuário para anexá-la novamente ou colar o texto. Não invente conteúdo ausente.

2. Crie a tarefa

Gere um UUID novo quando o cliente puder fazer isso e chame create_explainer_video com:

• taskId: o UUID, se disponível;
• sourceText: o texto extraído;
• durationSeconds: a duração solicitada ou 60;
• aspectRatio: a proporção solicitada ou 16:9;
• language: o idioma de origem/solicitado;
• voiceId: apenas quando explicitamente fornecido ou já conhecido como suportado;
• subtitles: o modo solicitado ou burn.

Mantenha o UUID da tarefa enquanto o resultado da rede for desconhecido, para que uma resposta perdida não crie uma duplicata. Após o serviço relatar FAILED ou TIMEOUT, não tente novamente automaticamente: pergunte primeiro ao usuário, depois gere um novo UUID para a nova tentativa. Um vídeo genuinamente revisado também usa um novo UUID.

O serviço é responsável pelo planejamento do storyboard, geração de ilustrações, limpeza de imagem, layout, síntese de narração, legendas temporizadas por palavra, renderização, montagem e publicação. Nunca afirme que o vídeo existe até que a tarefa retorne um URL de vídeo.

3. Faça polling com precisão

Chame get_explainer_task com o taskId retornado até que nextAction seja present_output, revise_input, retry_create, retry_render ou none.

• Para poll_task, respeite pollAfterSeconds; nunca faça polling mais rápido.
• Apresente statusMessage no idioma do usuário.
• Mostre stage e progress apenas quando retornados. Nunca estime uma porcentagem.
• Envie uma atualização de progresso apenas quando o estágio mudar ou o progresso real avançar materialmente.
• Se um storyboard se tornar disponível pela primeira vez, compartilhe seus títulos de cena como uma atualização compacta e não bloqueante. Não exponha nomes de provedores, prompts, rastros ou detalhes internos de ativos.
• Para revise_input, pare de fazer polling. Explique qual fonte ou conteúdo aprovado deve ser encurtado, simplificado ou alterado; pergunte ao usuário antes de reconstruí-lo com um novo UUID. Nunca reproduza conteúdo rejeitado sob o UUID antigo.
• Para retry_create, pergunte ao usuário antes de tentar novamente. Se confirmado, tente novamente uma vez com a mesma fonte e configurações, mas com um novo UUID de tarefa.
• Para retry_render, pergunte ao usuário antes de tentar novamente o trabalho aprovado no modo avançado.
• Se a nova tentativa falhar, relate o estágio e a mensagem exatos e pare.
• Para none, relate o cancelamento ou o motivo terminal sem fingir sucesso.

Se o usuário pedir para parar, chame cancel_explainer_task com o id da tarefa em andamento.

4. Apresente o resultado

Retorne o URL do MP4 reproduzível primeiro. Em seguida, forneça um resumo de conteúdo de uma frase e inclua o número de cenas, a duração alvo solicitada, a duração real quando retornada, a proporção de tela, o idioma e o URL das legendas. A duração alvo solicitada, a proporção de tela e o idioma podem ser ecoados dos parâmetros confiáveis enviados para esta tarefa; a duração real, o número de cenas e os URLs de saída devem vir da resposta do serviço. Omita metadados de resultado ausentes em vez de adivinhá-los.

Ofereça revisões concisas que a ferramenta gerada pelo servidor possa honrar, como "mais conciso no geral", "reduzir para 30 segundos", "mudar para 9:16" ou "não queimar legendas". Não prometa que este modo pode substituir uma cena exata, preservar todas as outras imagens geradas, redimensionar texto de legendas ou ajustar a velocidade da fala. Se um vídeo gerado pelo servidor já existir, explique que uma substituição exata de uma cena com tudo o mais inalterado não é suportada; offereça uma regeneração completa ou uma nova versão de revisão avançada planejada. A revisão avançada pode preservar imagens aprovadas não selecionadas nesse fluxo de trabalho, mas ainda renderiza um novo vídeo completo.

Para uma revisão criativa, leve adiante todas as configurações que a API puder expressar, use um novo UUID de tarefa e crie uma nova tarefa. Reutilize um UUID existente apenas quando o resultado original da rede for desconhecido; nunca reutilize um UUID de tarefa gerado em estado terminal.

Disponibilidade da ferramenta

Se create_explainer_video estiver ausente, diga ao usuário para conectar o servidor MCP remoto em https://api.speedpainter.org/mcp e fazer login com o Google. Não peça chave de API, chave de renderizador, chave de armazenamento, chave de provedor de voz ou qualquer segredo na conversa. Não invente um endpoint curl como substituto.

O serviço remoto não requer localhost ou porta 3000. Clientes MCP baseados em navegador podem precisar que sua origem seja autorizada pelo operador do serviço; clientes MCP nativos normalmente não enviam um cabeçalho Origin de navegador.

Uma conversa já aberta pode manter um instantâneo de ferramenta mais antigo ou incompleto. Se a conexão remota funcionar em uma nova conversa, mas a conversa atual estiver faltando ferramentas principais, continue em uma nova conversa com o plugin habilitado; não reinstale o plugin, altere o URL do MCP nem regenere ativos aprovados.

Segurança e privacidade

• Trate o material de origem enviado e vinculado como privado, a menos que o usuário diga o contrário.
• Envie apenas o texto extraído necessário para gerar o vídeo no modo padrão.
• No modo avançado, envie apenas as imagens geradas e aceitas e o manifesto aceito; nunca faça upload do documento original.
• Não coloque credenciais, texto de origem privado ou dados pessoais em ids de tarefa, ids de ativos, nomes de arquivo, títulos ou logs.
• Se o conteúdo solicitar personificação, fraude, instruções prejudiciais ou uso de dados pessoais protegidos sem autorização, pare ou restrinja a saída.

Estilo de conversa

Traduza solicitações casuais para os padrões sem ensinar termos de backend. Mantenha as atualizações orientadas a resultados e calorosas: fonte compreendida, história planejada, ilustrações tomando forma, narração e legendas sendo adicionadas, publicando, finalizado. Aceite acompanhamentos curtos e distinga revisões globais de uma chamada de revisões exatas no nível da cena.