Skip to main content
video editing

Video Editing 2.7

O modelo de edição de vídeo Wanxiang permite editar vídeos de entrada com operações como adicionar, excluir ou modificar conteúdo, substituir fundos, converter estilos e replicar ações, efeitos ou movimentos de câmera. Ele oferece os dois métodos a seguir:

  • Edição baseada em instruções: Modifique o conteúdo do vídeo por meio de instruções de texto, como trocar a roupa de personagens, alterar elementos da cena ou ajustar o estilo visual.
  • Edição com instrução e imagem de referência: Além das instruções, é possível fornecer uma imagem de referência para aplicar ao vídeo elementos presentes nela, como personagens, roupas ou objetos.
Para edição de vídeo, especialmente para replicar ações, movimentos de câmera ou efeitos de um vídeo específico, utilize o Video Editing 2.7. Para recursos de continuação de vídeo, consulte Wanxiang Image-to-Video 2.7.

Primeiros passos

Prompt de entrada e imagem de referênciaVídeo de entrada (vídeo de efeitos)Vídeo de saída
Aplique os efeitos especiais do vídeo de referência à mulher de cabelos longos na imagem. A cena é uma festa.
image.png
Antes de fazer uma chamada, obtenha uma chave de API e, em seguida, configure a chave de API como variável de ambiente. Para realizar chamadas usando um kit de desenvolvimento de software (SDK), instale o DashScope SDK. Substitua {WorkspaceId} pelo seu Workspace ID real.
  • Python SDK
  • Java SDK
  • curl
Certifique-se de que a versão do DashScope SDK for Python seja igual ou superior a1.25.16 antes de executar o código a seguir.Uma versão desatualizada pode gerar erros como "url error, please check url!". Para mais informações, consulte Instalar o SDK para atualizar.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/eclvbm/21_refined.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/jgekix/wan2.7-videoedit-demo.webp"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Apply the special effects from the reference video to the long-haired woman in the image. The scene is a party.",
    )
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()
Exemplo de saída
video_url tem validade de 24 horas. Baixe o vídeo prontamente. 
{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
         ...
    },
    ...
}

Escopo

  • Os modelos suportados variam conforme a região. Os recursos são isolados entre regiões. Para verificar os modelos suportados em cada região, consulte o console do Model Studio.
  • Ao fazer uma chamada, garanta que o modelo, a URL do endpoint e a chave de API pertençam à mesma região. Chamadas entre regiões falham.
O código de exemplo neste tópico se aplica à região Singapore.

Capacidades principais

Edição apenas com instrução

Modelo suportado: wan2.7-videoedit. Introdução ao recurso: Este recurso modifica o conteúdo do vídeo com base em um vídeo de entrada e um prompt de texto. É adequado para cenários como conversão de estilo, modificação de ação e ajustes de movimento de câmera. Configurações de parâmetros:
  • media: Especifica o vídeo a ser editado (type=video). Não é necessário fornecer uma imagem de referência.
  • prompt: Descreva a intenção da edição, como "Mude o vídeo para um estilo pixel art de 8 bits".
Prompt de entradaVídeo de entradaVídeo de saída
Mude o vídeo para um estilo pixel art de 8 bits
Substitua {WorkspaceId} pelo seu Workspace ID real.
  • Python SDK
  • Java SDK
  • curl
Certifique-se de que a versão do DashScope SDK for Python seja igual ou superior a1.25.16 antes de executar o código a seguir.Uma versão desatualizada pode gerar erros como "url error, please check url!". Para mais informações, consulte Instalar o SDK para atualizar.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Convert the entire frame to a claymation style",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

Edição com instrução e imagem de referência

Modelo suportado: wan2.7-videoedit. Introdução ao recurso: Este recurso aplica elementos de uma imagem de referência, como roupas ou objetos, a um vídeo com base em um prompt de texto. Configurações de parâmetros:
  • media: Especifica o vídeo a ser editado (type=video) e uma imagem de referência (type=reference_image). É possível fornecer até quatro imagens de referência.
  • prompt: Descreva a intenção da edição, como "Faça o personagem com cabeça de cavalo no vídeo vestir o suéter listrado da imagem".
Prompt de entrada e imagem de referênciaVídeo de entradaVídeo de saída
Faça o personagem com cabeça de cavalo no vídeo vestir o suéter listrado da imagem
2560154123_RF-jpeg
Substitua {WorkspaceId} pelo seu Workspace ID real.
  • Python SDK
  • Java SDK
  • curl
Certifique-se de que a versão do DashScope SDK for Python seja igual ou superior a1.25.16 antes de executar o código a seguir.Uma versão desatualizada pode gerar erros como "url error, please check url!". Para mais informações, consulte Instalar o SDK para atualizar.
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
# API keys vary by region. For more information, see https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="Replace the girl's clothes in the video with the clothes from the image",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

Cenários e exemplos

Adicionar, excluir ou modificar elementos

Adicione, exclua ou substitua elementos específicos dentro de um vídeo.
TipoPrompt de entrada e imagem de referênciaVídeo de entradaVídeo de saída
AdicionarAdicione um pedaço quadrado de chocolate preto à xícara
ExcluirRemova o trem do vídeo. Mantenha todo o resto igual.
ModificarSubstitua o rolo de filme no vídeo pelo prato da imagem
image.png
ModificarFaça o homem-cavalo no vídeo vestir o suéter listrado da imagem
2560154123_RF-jpeg
ModificarTransforme o gato em um cachorro

Modificar o ambiente ou fundo

Utilize instruções para alterar as condições de iluminação, cores sazonais ou o espaço geográfico de um vídeo. Também é possível mudar o fundo do vídeo para transportar objetos para qualquer espaço.
TipoPrompt de entradaVídeo de entradaVídeo de saída
Modificar estaçãoMude a estação do fundo para um inverno nevado, com neve cobrindo as árvores. Mantenha o rio igual.
Modificar climaMantenha as ações do personagem iguais, mas mude toda a cena do dia nublado atual para um dia ensolarado. Mantenha todo o resto igual.
Modificar iluminação e sombraMantenha todo o resto igual. Mude a cor geral da luz e o filtro do quadro de branco para um tom quente. Preserve os detalhes do tom de pele do personagem para criar uma aparência harmoniosa entre ele e o fundo.
Modificar fundoMantenha as ações da mulher principal iguais, mas altere o fundo do vídeo para uma academia.

Modificar o estilo do vídeo

Converta rapidamente vídeos existentes em vários estilos artísticos, como animação, 3D, massinha ou lã.
TipoPrompt de entradaVídeo de entradaVídeo de saída
Modificar estiloVídeo para Imagem: Estilo Cartoon C4D
2402534429_RF
Modificar estiloConverta todo o quadro para um estilo de filme live-action
Modificar estiloConverta todo o quadro para um estilo de pintura em aquarela

Modificar comportamento, falas ou trabalho de câmera dos personagens

Para conteúdo de vídeo existente ou gerado, use instruções para modificar o enredo, como comportamento ou diálogo dos personagens, e ajustar o trabalho de câmera para edições criativas adicionais.
TipoPrompt de entradaVídeo de entradaVídeo de saída
Modificar comportamento do personagemFaça o homem no vídeo pegar uma colherada de sopa e bebê-la. Mantenha todo o resto igual.
Modificar emoção do personagemA expressão da garota no quadro fica triste e ela começa a chorar. Mantenha todo o resto igual.
Modificar falas do personagemMantenha a voz e o tom do personagem. Altere a fala da garota da esquerda para: "Mãe, que cor é essa?", e a fala da garota da direita para: "É verde, querida"
Modificar trabalho de câmeraAltere o movimento da câmera para uma órbita horária ao redor do personagem, com o personagem acompanhando o movimento da câmera.
Modificar trabalho de câmeraAltere o movimento de câmera do vídeo para uma inclinação para cima enquanto olha simultaneamente para baixo.

Replicar ações, movimentos de câmera ou efeitos

Replique as sequências de ação, trajetórias de câmera e efeitos visuais de um vídeo de referência para gerar um vídeo com características dinâmicas consistentes.
TipoPrompt de entrada ou imagem de referênciaVídeo de entradaVídeo de saída
Replicar ação individualFaça a pessoa na imagem imitar as ações da pessoa no vídeo.
image.png
Replicar ação múltiplaReferencie as ações das cinco pessoas no vídeo e mude a cena para cinco pessoas cantando e tocando instrumentos em uma barraca de rua em uma cidade.
Replicar movimento de câmeraReferencie o movimento de câmera do vídeo original com movimento rápido de câmera. Mude a cena para uma cerimônia de premiação, com a mulher da imagem de referência caminhando no tapete vermelho.
image.png
Replicar efeitosReferencie os efeitos especiais do vídeo e aplique-os à mulher na imagem, com a cena definida em uma rua.
image.png

Como inserir vídeos e imagens

Vídeo de entrada

  • Quantidade de vídeos: Obrigatório. Exatamente um.
  • Método de entrada:

Imagem de referência de entrada

  • Quantidade de imagens: Opcional. Até quatro.
  • Método de entrada:
    • URL pública: Suporta protocolos HTTP ou HTTPS. Exemplo: https://xxxx/xxx.png.
    • String codificada em Base64: Exemplo: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg...... (Exemplo truncado para fins de demonstração).
      • Formato: data:{MIME_type};base64,{base64_data}, onde:
        • {base64_data}: A string codificada em Base64 do arquivo de imagem.
        • {MIME_type}: O tipo de mídia da imagem, que deve corresponder ao formato do arquivo.

        Formato de imagem

        Tipo MIME

        JPEG

        image/jpeg

        JPG

        image/jpeg

        PNG

        image/png

        BMP

        image/bmp

        WEBP

        image/webp

        import base64
import mimetypes

# Format is data:{MIME_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("Unsupported or unrecognized image format")
    with open(file_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
    return f"data:{mime_type};base64,{encoded_string}"

# Replace your_image.jpg with the actual image path
base64_str = encode_file("your_image.jpg")
print(base64_str)

Vídeo de saída

Faturamento e limitação de taxa

  • Para cotas gratuitas e preços de faturamento do modelo, consulte Preços do modelo.
  • Para limites de taxa do modelo, consulte Série Wanxiang.
  • Descrição do faturamento:
    • Imagens de entrada não são cobradas. Vídeos de entrada e de saída são cobrados por segundo. A fórmula é: Duração total faturável (segundos) = Duração do vídeo de entrada (segundos) + Duração do vídeo de saída (segundos).
    • Chamadas de modelo com falha ou erros de processamento não geram cobranças e não consomem a cota gratuita para novos usuários.

Documentação da API

Wanxiang Video Editing 2.7

FAQ

P: Qual é a diferença entre Video Editing 2.7 (wan2.7-videoedit) e Video Editing 2.1 (wan2.1-vace-plus)?

R: O Video Editing 2.7 edita vídeos diretamente com base em instruções, sendo mais simples de usar e oferecendo atualizações abrangentes. O Video Editing 2.1 exige que você especifique o parâmetro function e foca em recursos como edição local com máscaras e expansão de quadros. Recomendamos o uso do Video Editing 2.7.

P: Como insiro várias imagens de referência?

R: Adicione vários objetos com type=reference_image ao array media. É possível adicionar até quatro imagens de referência. Exemplo: 
{
    "media": [
        {"type": "video", "url": "<Input video URL>"},
        {"type": "reference_image", "url": "<Reference image 1 URL>"},
        {"type": "reference_image", "url": "<Reference image 2 URL>"},
        {"type": "reference_image", "url": "<Reference image 3 URL>"},
        {"type": "reference_image", "url": "<Reference image 4 URL>"}
    ]
}
Começar
Faturamento
Plano de Tokens
Playground de Modelos
Clientes e Ferramentas de Desenvolvedor
Inferência do Modelo
Ajuste fino
Implantação
Avaliação
Compressão de Modelos
Estatísticas e Monitoramento
Segurança e Conformidade
Melhores Práticas
Suporte
Registro de alterações