CapCutAPI: ferramenta de código aberto para controle automatizado de clipes de vídeo CapCut

O CapCutAPI é um projeto de código aberto hospedado no GitHub e criado pelo desenvolvedor sun-guannan. Ele é baseado no desenvolvimento Python, projetado para automatizar o controle do CapCut (imagem cortada) por meio do código para edição de vídeo. Os usuários podem automatizar a edição de vídeo escrevendo scripts que incluem recursos como criação de rascunhos, adição de clipes, aplicação de efeitos e geração de legendas. A ferramenta é adequada para desenvolvedores e criadores de conteúdo que precisam processar vídeos em lote ou que estejam buscando uma edição eficiente. O projeto está atualmente em fase de desenvolvimento ativo, com documentação detalhada e código de amostra fornecidos para que os usuários possam começar rapidamente. O objetivo principal do CapCutAPI é simplificar o processo de edição de vídeo, reduzir o tempo de operação manual e aumentar a eficiência criativa.

Lista de funções

• Criação automática de rascunhos de clipes de vídeo e suporte para inicialização rápida de projetos.
• Suporte à adição de vídeo, imagens, áudio e muitos outros materiais.
• Oferece aplicativos automatizados para efeitos e transições de vídeo.
• Serviços de IA integrados, geração automática de legendas e suporte a vários idiomas.
• Suporta o processamento em lote de vídeos, adequado para a produção de conteúdo em larga escala.
• Fornece controles com script que permitem aos usuários personalizar a lógica de edição.
• Suporte à exportação de vídeos sem marca d'água para atender às necessidades profissionais.

Usando a Ajuda

O CapCutAPI é uma ferramenta de código aberto baseada em Python projetada para ajudar os usuários a automatizar a edição de vídeo controlando o CapCut (recorte) por meio de código. Abaixo está um guia detalhado de instalação e uso para ajudar os usuários a começar rapidamente.

Processo de instalação

1. Preparação ambiental
   Certifique-se de ter o Python 3.8 ou superior instalado em seu computador. Você pode verificar a versão do Python com o seguinte comando:

   python --version
   

   Se o Python não estiver instalado, inicie o programa Site oficial do Python Faça o download e instale.

2. projeto de clonagem
   O CapCutAPI está hospedado no GitHub. Você precisa clonar o projeto localmente usando o Git. Abra um terminal e execute o seguinte comando:

   git clone https://github.com/sun-guannan/CapCutAPI.git
   

   Se você não tiver o Git instalado, poderá obtê-lo em Site do Git Faça o download.

3. Instalação de dependências
   Vá para o catálogo de projetos:

   cd CapCutAPI
   

   As dependências do projeto estão listadas na seção requirements.txt arquivo. Instale as dependências:

   pip install -r requirements.txt
   

   Certifique-se de que sua conexão de rede esteja funcionando e que suas dependências incluam bibliotecas Python comuns, como requests responder cantando pydub.

4. Configuração do CapCut
   O CapCutAPI é necessário para funcionar com o software CapCut instalado. Certifique-se de que seu computador ou dispositivo tenha a versão mais recente do CapCut instalada (disponível na seção Site oficial do CapCut (Download). Alguns recursos podem exigir o CapCut Professional; é recomendável verificar se a sua versão do CapCut suporta chamadas de API.
5. Definição de variáveis de ambiente
   Alguns recursos, como a geração de legendas com IA, exigem uma chave de API para serem configurados. Salve a chave em uma variável de ambiente ou em um arquivo de configuração do projeto. config.json no diretório raiz do projeto. Consulte o diretório raiz do projeto para obter detalhes sobre como configurar o README.md Documentação.

Uso

O núcleo do CapCutAPI é controlar as funções de edição do CapCut por meio de scripts Python. Abaixo está um fluxo detalhado das principais funções.

Criação de um rascunho de vídeo

estar em movimento create_draft.py O script cria um novo projeto CapCut de rascunho. Código de amostra:

from capcut_api import CapCutAPI
api = CapCutAPI()
draft_id = api.create_draft(project_name="MyVideo")
print(f"Created draft with ID: {draft_id}")

• Uma vez executado, o CapCut gerará automaticamente um rascunho de um novo projeto com um ID que será usado em operações subsequentes.
• Certifique-se de que o software CapCut esteja ativado; caso contrário, as chamadas à API poderão falhar.

Adicionar material

O CapCutAPI suporta a adição de clipes de vídeo, imagem e áudio. Código de amostra:

api.add_material(draft_id, material_type="video", file_path="path/to/video.mp4")
api.add_material(draft_id, material_type="audio", file_path="path/to/audio.mp3")

• material_type apoiar algo "video"e"image" responder cantando "audio".
• O caminho do arquivo precisa ser um caminho absoluto para um arquivo local.
• O clipe é adicionado automaticamente à trilha padrão da linha do tempo, e a posição pode ser ajustada por parâmetros.

Aplicação de efeitos e transições

O CapCutAPI permite que efeitos especiais e transições sejam aplicados automaticamente. Por exemplo, adicionar transições de esmaecimento:

api.apply_transition(draft_id, transition_type="fade", duration=1.0)

• transition_type Há suporte para uma variedade de efeitos, como "fade"e"slide" etc., consulte a documentação para obter uma lista.
• duration O parâmetro controla a duração da transição (em segundos).

Geração automática de legendas

O CapCutAPI integra a geração de legendas de IA, o que exige a configuração de uma chave de serviço de IA. Código de amostra:

api.generate_subtitles(draft_id, language="zh-CN", output_path="subtitles.srt")

• language Os parâmetros são compatíveis com vários idiomas, como "zh-CN"(em chinês),"en-US"(Inglês).
• Os arquivos de legenda gerados são salvos no caminho especificado, com suporte para .srt responder cantando .vtt Formato.
• Recomenda-se um áudio de vídeo nítido para melhorar a precisão da legenda.

Exportar vídeo

Após terminar a edição, você pode exportar o vídeo sem marca d'água:

api.export_video(draft_id, output_path="path/to/output.mp4", resolution="1080p")

• resolution apoiar algo "720p"e"1080p" etc., dependendo da versão do CapCut.
• O processo de exportação pode levar alguns minutos, dependendo da duração do vídeo.

advertência

• referência de documentação: o diretório raiz do projeto README.md responder cantando examples/ A pasta contém um código de amostra detalhado, que deve ser lido com atenção ao ser usado pela primeira vez.
• ajustar os componentes durante o testeSe encontrar um erro ao executar o script, verifique se o CapCut está em execução e se a conexão de rede está funcionando.
• compatibilidadeCapCutAPI: O CapCutAPI é compatível principalmente com a versão desktop do CapCut para as plataformas Windows e macOS, com suporte limitado para dispositivos móveis.
• Suporte à comunidadeSe você tiver dúvidas, registre um problema no GitHub ou consulte a discussão da comunidade.

Com essas etapas, os usuários podem começar a usar rapidamente o CapCutAPI para automatizar a edição de vídeo. Seja para gerar vídeos curtos em lote ou para lidar com tarefas de edição complexas, a ferramenta pode aumentar significativamente a eficiência.

cenário do aplicativo

1. Produção em massa de vídeos curtos
   Os criadores de conteúdo precisam gerar rapidamente um grande número de vídeos curtos (por exemplo, conteúdo Shake e Faster). O CapCutAPI pode gerar automaticamente vários vídeos importando clipes em lote, adicionando legendas e efeitos por meio de scripts, reduzindo o tempo de operações repetitivas.
2. Produção de vídeos educacionais
   Professores ou organizações de treinamento precisam criar vídeos instrucionais legendados para seus cursos, e o recurso de legendagem com IA do CapCutAPI gera automaticamente legendas precisas com efeitos especiais para aumentar o apelo de seus vídeos.
3. Automação de vídeos de marketing
   As empresas precisam criar vídeos promocionais para seus produtos. O CapCutAPI oferece suporte à importação rápida de filmagens de marca e aplica automaticamente efeitos e transições unificados para campanhas de marketing em grande escala.
4. Clipes de projetos pessoais
   Desenvolvedores independentes ou entusiastas de vídeo podem usar o CapCutAPI para escrever scripts personalizados para implementar uma lógica de edição complexa, como o ajuste dinâmico da linha do tempo ou o processamento em lote de vários clipes.

QA

1. Há alguma taxa para o CapCutAPI?
   O CapCutAPI é um projeto gratuito de código aberto hospedado no GitHub. No entanto, alguns recursos (como legendas com IA) podem exigir o CapCut Pro ou uma chave de serviço de IA de terceiros, dependendo do provedor de serviços.
2. O CapCut é compatível com dispositivos móveis?
   Atualmente, o CapCutAPI é compatível principalmente com as versões desktop do CapCut (Windows e macOS). O suporte a dispositivos móveis é limitado, portanto, recomendamos verificar a documentação oficial para obter as informações mais recentes sobre compatibilidade.
3. Como faço para resolver falhas de chamadas à API?
   Certifique-se de que o software CapCut esteja em execução, verifique a conexão de rede e a configuração da chave de API. Se ainda assim falhar, envie um problema na página do projeto GitHub com um registro de erros.
4. É possível exportar vídeos sem marca d'água?
   Sim, o CapCutAPI suporta a exportação de vídeos sem marca d'água, mas verifique se você está usando o CapCut Pro ou se atende às condições para exportação sem marca d'água.