API Wan 2.7 VideoEdit no Novita AI: Editar Clipes Existentes com Prompts e Imagens de Referência

O Wan 2.7 VideoEdit no Novita AI é o endpoint correto quando você já possui filmagens e deseja que o modelo reestilize ou reescreva a cena sem reconstruir o movimento do zero. Você envia um vídeo de origem para POST https://api.novita.ai/v3/async/wan2.7-videoedit, recebe um task_id e então consulta GET /v3/async/task-result até que o clipe editado esteja pronto. Este guia mostra a forma exata da requisição, quando adicionar imagens de referência e os detalhes de implementação importantes antes de integrá-lo à produção.

Para uma comparação mais ampla entre os modos, veja Wan 2.7 no Novita AI: Texto-para-Vídeo vs Imagem-para-Vídeo vs Referência-para-Vídeo.

Quando o Wan 2.7 VideoEdit é a Ferramenta Certa

Use o Wan 2.7 VideoEdit quando o timing e o movimento da câmera no seu clipe de origem já forem bons o suficiente e você quiser que a IA mude o que o espectador vê, em vez de como a cena é enquadrada.

Aplicações típicas:

• Você tem um clipe de ação ao vivo e deseja convertê-lo em um render anime, cinematográfico ou estilizado.
• Você precisa mudar guarda-roupa, ambiente, adereços ou atmosfera enquanto preserva o arco de movimento original.
• Você deseja aplicar uma transformação guiada por prompt ao material de vídeo e, opcionalmente, ancorar a aparência com uma imagem de referência.

Não é o endpoint correto quando:

• Você precisa de movimento novo a partir apenas de texto. Use Wan 2.7 T2V.
• Você deseja animar uma imagem estática. Use Wan 2.7 I2V.
• Você precisa de role-play com vários personagens usando slots de referência nomeados em uma cena gerada. Use Wan 2.7 R2V.

Essa distinção é importante porque o VideoEdit parte de um clipe de entrada. Se o movimento original estiver errado, o modelo não corrigirá a coreografia para você.

Endpoint e Fluxo de Trabalho Verificados

O Wan 2.7 VideoEdit no Novita AI usa um endpoint de envio e o endpoint compartilhado de consulta de resultado assíncrono:

Campo	Valor
Endpoint de envio	POST https://api.novita.ai/v3/async/wan2.7-videoedit
Consulta de resultado	GET https://api.novita.ai/v3/async/task-result?task_id=<id>
Cabeçalho de autenticação	Authorization: Bearer $NOVITA_API_KEY
Tipo de conteúdo	application/json
Documentação oficial	Referência da API Wan 2.7 VideoEdit

A API é assíncrona. Uma chamada de envio bem-sucedida retorna um task_id, não o URL do vídeo finalizado. Sua aplicação deve persistir esse ID de tarefa e construir lógica de consulta ou trabalho em segundo plano em torno dele.

Etapa 1: Obter uma Chave de API do Novita AI

Crie uma chave a partir do gerenciamento de chaves do Novita AI e mantenha-a em uma variável de ambiente:

export NOVITA_API_KEY="your_api_key_here"

Não codifique a chave diretamente em código de navegador, aplicativos móveis ou arquivos de configuração versionados.

Etapa 2: Entender a Estrutura da Requisição

O Wan 2.7 VideoEdit usa um corpo JSON plano. A requisição não aninha campos sob input ou parameters.

No mínimo, envie:

• video_url
• prompt

Os campos opcionais documentados com os quais você normalmente se preocupará primeiro são:

• reference_image_url para uma referência de aparência/estilo
• resolution
• duration
• audio_setting
• prompt_extend
• seed

Etapa 3: Enviar Sua Primeira Requisição VideoEdit

Esta é a requisição prática mínima:

curl -s -X POST https://api.novita.ai/v3/async/wan2.7-videoedit \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/source-clip.mp4",
    "prompt": "Turn this office hallway scene into a neon cyberpunk corridor, preserve the walking motion and camera path",
    "resolution": "720P",
    "duration": 5
  }'

Resposta esperada:

{
  "task_id": "abc123..."
}

Nada mais é garantido no momento do envio. Trate a requisição como uma etapa de enfileiramento de trabalho, não como uma resposta de edição síncrona.

Etapa 4: Consultar o Endpoint de Resultado da Tarefa

Use o task_id retornado com a API de resultado de tarefa compartilhada:

curl -s "https://api.novita.ai/v3/async/task-result?task_id=abc123..." \
  -H "Authorization: Bearer $NOVITA_API_KEY"

Trabalhe com estes estados:

Status	Significado
TASK_STATUS_QUEUED	Aceito e aguardando execução
TASK_STATUS_PROCESSING	Edição em andamento
TASK_STATUS_SUCCEED	Vídeo editado pronto
TASK_STATUS_FAILED	A tarefa falhou; inspecione o corpo da resposta

Quando a tarefa for bem-sucedida, a resposta inclui um array videos com o URL do vídeo editado e o TTL do URL. Baixe ou mova esse ativo imediatamente, em vez de tratar o URL hospedado como armazenamento permanente.

Etapa 5: Adicionar uma Imagem de Referência Quando Precisar de Controle Visual mais Preciso

reference_image_url é opcional, mas altera o comportamento de edição de maneiras úteis.

Use quando:

• Você quiser que o clipe final siga uma aparência, figurino ou paleta de personagens específica.
• Você quiser direcionar a saída para uma direção artística específica, em vez de deixar tudo para o prompt de texto.
• O movimento do vídeo de origem está correto, mas a identidade da cena está muito vaga apenas com orientação textual.

Exemplo de requisição com imagem de referência:

curl -s -X POST https://api.novita.ai/v3/async/wan2.7-videoedit \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/source-clip.mp4",
    "reference_image_url": "https://example.com/reference-look.png",
    "prompt": "Transform the performer into the look and color palette of the reference image while keeping the same dance timing",
    "resolution": "1080P",
    "duration": 6,
    "audio_setting": "auto"
  }'

Se o resultado continuar desviando, a correção usual não é um prompt mais longo. É um prompt mais preciso combinado com uma imagem de referência melhor.

Parâmetros Chave com os Quais Você Realmente Deve se Importar

Parâmetro	Tipo	Obrigatório	O que faz
video_url	string	Sim	Vídeo de origem para editar
prompt	string	Sim	Descreve a transformação desejada
reference_image_url	string	Não	Imagem de referência para ancorar aparência e estilo
resolution	string	Não	Resolução de saída; valores documentados incluem 720P e 1080P
duration	integer	Não	Duração desejada da saída em segundos; 0 mantém a duração completa do vídeo de entrada
audio_setting	string	Não	Controla o comportamento de geração de áudio
prompt_extend	boolean	Não	Permite que o modelo expanda prompts curtos automaticamente
seed	integer	Não	Melhora a reprodutibilidade entre tentativas

Consulte a referência oficial de parâmetros antes de assumir valores padrão. Os campos dos modelos de vídeo mudam com mais frequência do que os campos dos modelos de texto, e é fácil errar nas restrições de saída se você confiar na memória.

Limites Documentados e Restrições Práticas

Em 29 de julho de 2026, a documentação oficial da Novita para o Wan 2.7 VideoEdit documenta estes limites:

• Resoluções suportadas: 720P e 1080P
• duration padrão é 0, que significa a duração completa do vídeo de entrada; a faixa explícita de duração de saída documentada é de 2 a 10 segundos quando você a define
• Formatos de vídeo de entrada: mp4 e mov
• Limite de tamanho do vídeo de entrada: até 100 MB
• Formatos de imagem de referência: jpg, jpeg, png, webp
• Limite de tamanho da imagem de referência: até 20 MB
• Formato de vídeo de saída: mp4

Essas restrições são fáceis de ignorar ao construir um pipeline de mídia genérico. A falha de integração mais comum é enviar um arquivo de origem mais longo ou maior do que o endpoint aceita.

Duas implicações práticas:

1. Se você quiser que o clipe editado preserve a duração da origem, omita duration ou defina-o como 0 em vez de forçar um corte de 2 a 10 segundos.
2. Se você estiver testando prompts rapidamente, use 720P primeiro e migre para 1080P somente quando a transformação estiver funcionando.

Exemplo em Python: Enviar e Consultar

import os
import time
import requests

API_KEY = os.environ["NOVITA_API_KEY"]
BASE_URL = "https://api.novita.ai"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}


def submit_video_edit(
    video_url: str,
    prompt: str,
    reference_image_url: str | None = None,
    resolution: str = "720P",
    duration: int = 0,
    audio_setting: str = "auto",
    prompt_extend: bool = True,
    seed: int | None = None,
) -> str:
    payload = {
        "video_url": video_url,
        "prompt": prompt,
        "resolution": resolution,
        "duration": duration,
        "audio_setting": audio_setting,
        "prompt_extend": prompt_extend,
    }
    if reference_image_url:
        payload["reference_image_url"] = reference_image_url
    if seed is not None:
        payload["seed"] = seed

    resp = requests.post(
        f"{BASE_URL}/v3/async/wan2.7-videoedit",
        headers=HEADERS,
        json=payload,
        timeout=60,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]


def poll_result(task_id: str, interval: int = 5, timeout: int = 300) -> dict:
    deadline = time.time() + timeout
    while time.time() < deadline:
        resp = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers=HEADERS,
            params={"task_id": task_id},
            timeout=60,
        )
        resp.raise_for_status()
        data = resp.json()
        status = data.get("task", {}).get("status")

        if status == "TASK_STATUS_SUCCEED":
            return data
        if status == "TASK_STATUS_FAILED":
            reason = data.get("task", {}).get("reason", "unknown")
            raise RuntimeError(f"Task {task_id} failed: {reason}")

        time.sleep(interval)

    raise TimeoutError(f"Task {task_id} did not complete within {timeout}s")


if __name__ == "__main__":
    task_id = submit_video_edit(
        video_url="https://example.com/source-clip.mp4",
        prompt="Change the street scene into a rainy retro-futurist city at night, preserve the original tracking shot",
        reference_image_url="https://example.com/reference-frame.png",
        resolution="720P",
        duration=0,
        seed=42,
    )
    print(f"Submitted task: {task_id}")

    result = poll_result(task_id)
    video = result["videos"][0]
    print("Edited video URL:", video["video_url"])
    print("URL TTL:", video["video_url_ttl"])

Exemplo em cURL com Consulta em Shell

TASK_ID=$(curl -s -X POST https://api.novita.ai/v3/async/wan2.7-videoedit \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/source-clip.mp4",
    "prompt": "Convert the clip into a hand-drawn anime city scene, preserve the running motion",
    "resolution": "720P",
    "duration": 0,
    "prompt_extend": true
  }' | jq -r '.task_id')

while true; do
  RESULT=$(curl -s "https://api.novita.ai/v3/async/task-result?task_id=$TASK_ID" \
    -H "Authorization: Bearer $NOVITA_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.task.status')

  if [ "$STATUS" = "TASK_STATUS_SUCCEED" ]; then
    echo "$RESULT" | jq -r '.videos[0].video_url'
    break
  fi

  if [ "$STATUS" = "TASK_STATUS_FAILED" ]; then
    echo "$RESULT"
    break
  fi

  sleep 5
done

Se estiver integrando a partir de um serviço backend, envolva este loop de consulta em um worker em vez de manter uma requisição de usuário aberta por toda a janela de geração.

Preços, Créditos e o que Verificar Antes de Estimar Custos

A Novita AI exibe preços para modelos de vídeo em suas páginas de modelo e preços, mas esses números podem mudar. Para o Wan 2.7 VideoEdit, verifique as taxas atuais diretamente na página de preços da Novita AI e na entrada do modelo vinculada na documentação oficial antes de publicar estimativas de custo voltadas ao cliente.

Para planejamento de engenharia, a suposição mais segura é:

• O custo escala com as configurações do clipe gerado, não apenas com uma taxa fixa por requisição.
• Execuções em 1080P são a linha de base errada para iteração.
• Clipes mais curtos são mais fáceis de validar e mais baratos de depurar.

Se você estiver construindo ferramentas internas, trate a consulta de preços como uma preocupação de configuração, não como uma constante embutida no código.

Erros Comuns de Integração

Enviar uploads brutos em vez de um URL acessível. A forma da requisição documentada espera entradas de mídia baseadas em URL. Certifique-se de que seu clipe de origem já esteja disponível em um URL estável que seu servidor possa referenciar.

Usar VideoEdit para mudanças de movimento. VideoEdit é um endpoint de transformação, não um endpoint de coreografia. Se o movimento original estiver errado, regenere com T2V ou I2V.

Confundir os limites do vídeo de origem e da imagem de referência. O vídeo de origem é o ativo maior: mp4/mov, até 100 MB. O limite menor de 20 MB se aplica a reference_image_url, não a video_url.

Consultar com muita agressividade. Acessar o endpoint de resultado da tarefa a cada segundo é desnecessário para trabalhos de vídeo de vários segundos. Um intervalo de 5 a 10 segundos geralmente é um ponto de partida melhor.

Ignorar o TTL do URL. O URL do resultado é temporário. Persista o ativo imediatamente se o clipe editado for importante adiante.

Pular a especificidade do prompt. “Melhore isso” não é um prompt de edição. Descreva o estilo alvo, ambiente, tratamento do assunto e qual movimento deve permanecer inalterado.

Qual Endpoint Wan 2.7 Você Deve Escolher?

Use esta regra rápida:

• Escolha VideoEdit quando você já tiver um vídeo de origem.
• Escolha I2V quando você tiver uma imagem de origem ou quiser continuar a partir de um fluxo de trabalho liderado por imagem.
• Escolha T2V quando você tiver apenas texto.
• Escolha R2V quando a consistência de identidade e o controle de personagens de referência forem mais importantes do que editar um clipe existente.

Essa separação é o que mantém sua integração simples. As equipes costumam usar texto-para-vídeo em excesso para tarefas que são, na verdade, problemas de edição baseados em prompt.

Se você estiver construindo orquestração em torno deste endpoint, compare Macaron V1 Tall Quick Start no Novita AI e Qwen3.8-Max no Novita AI para âncoras de modelo de maior peso.

FAQ

Qual é o endpoint da Novita AI para Wan 2.7 VideoEdit?

POST https://api.novita.ai/v3/async/wan2.7-videoedit. Ele retorna um task_id, então você consulta GET https://api.novita.ai/v3/async/task-result?task_id=<id> para ver a conclusão.

Posso fornecer uma imagem de referência junto com o vídeo de origem?

Sim. A forma da requisição documentada suporta um reference_image_url opcional junto com video_url e prompt, o que é útil para direcionar a aparência final com mais precisão.

Qual duração de vídeo o Wan 2.7 VideoEdit suporta no Novita AI?

Conforme documentado em 29 de julho de 2026, duration padrão é 0, que significa a duração completa do vídeo de entrada. Se você definir duration explicitamente, a faixa documentada é de 2 a 10 segundos.

O Wan 2.7 VideoEdit aceita vídeos de origem grandes?

Sim, dentro do limite documentado. A documentação oficial lista entrada mp4/mov de até 100 MB. O limite separado de 20 MB se aplica à imagem de referência opcional.

Devo usar Wan 2.7 VideoEdit ou Wan 2.7 I2V?

Use VideoEdit se você já tiver um clipe e quiser transformá-lo. Use I2V se seu ponto de partida for uma imagem estática ou um fluxo de trabalho liderado por imagem.

Artigos recomendados

• Wan 2.7 no Novita AI: Texto-para-Vídeo vs Imagem-para-Vídeo vs Referência-para-Vídeo
• Kling O1 no Novita AI: Modos T2V, I2V, Ref2V e Video Edit
• PixVerse V4.5 Quick Start para Geração de Texto-para-Vídeo e Imagem-para-Vídeo