--- title: "Documentação do MIDI Agent | Guia do plugin VST" description: "Aprenda a instalar o MIDI Agent e usá-lo com sua conta do ChatGPT, chaves de API de provedores, modelos locais ou MIDI Agent Pro." canonical_url: "https://www.midiagent.com/pt-br/documentacao" md_url: "https://www.midiagent.com/pt-br/documentacao.md" author: "MIDI Agent" author_url: "https://www.midiagent.com/about" last_updated: "2026-10-11" date_basis: "manualReviewed" generated_at: "2026-10-12T00:00:00.000Z" --- 1. [Início](https://www.midiagent.com/pt-br) 2. Documentação # Documentação do plugin MIDI Agent Visão geral Instalação Principais recursos Interface do usuário Fluxo de trabalho Boas práticas Solução de problemas ## Visão geral O plugin MIDI Agent é uma ferramenta poderosa desenvolvida para aprimorar seu fluxo de produção musical com inteligência artificial para gerar e modificar MIDI diretamente na sua estação de trabalho de áudio digital (DAW). Ele permite criar melodias, harmonias e ritmos MIDI originais a partir de instruções de texto, converter áudio em MIDI e completar sequências MIDI existentes com modelos de IA compatíveis. ## Instalação e ativação O MIDI Agent está disponível como plugin VST3 e também nos formatos AU, AAX e aplicativo independente. Execute o instalador e escolha os formatos desejados; você não precisa de uma DAW para usar o aplicativo independente. 1. **Download:** Baixe o instalador para seu sistema operacional na página da sua conta. 2. **Instalação:** Execute o instalador e selecione o aplicativo independente e os formatos de plugin necessários. Caminhos padrão: - **Aplicativo independente:** - C:\Program Files\MIDI Agent\MIDI Agent.exe - /Applications/MIDI Agent.app - **VST3:** - C:\Program Files\Common Files\VST3 - /Library/Audio/Plug-Ins/VST3 - **AU (macOS):** - /Library/Audio/Plug-Ins/Components - **AAX (Pro Tools):** - C:\Program Files\Common Files\Avid\Audio\Plug-Ins - /Library/Application Support/Avid/Audio/Plug-Ins 3. **Abra o MIDI Agent:** Abra o aplicativo independente pelo menu Iniciar ou pela pasta Aplicativos, ou abra sua DAW e carregue o MIDI Agent em uma faixa MIDI ou de instrumento. 4. **Licença:** Insira sua chave de licença no painel de configurações. 5. **Verificação:** Clique em “Salvar” para verificar sua licença online. 6. **Escolha seu acesso à IA:** Conecte sua conta do ChatGPT, adicione uma chave de API de provedor, conecte um modelo local ou assine o MIDI Agent Pro. 7. **Comece a gerar:** Selecione um provedor de API (ou MIDI Agent para assinantes Pro), escolha um modelo, escreva uma instrução e clique em enviar para gerar música. No aplicativo independente, arraste o arquivo .mid gerado diretamente para qualquer DAW. ## Principais recursos - **Geração de MIDI com IA:** Gere padrões MIDI únicos e inspiradores usando instruções de texto. - **Conversão de áudio para MIDI:** Converta gravações de áudio em dados MIDI. - **Continuação de MIDI:** Amplie e aprimore sequências MIDI existentes. - **Seleção flexível de modelos de IA:** Escolha entre diferentes provedores de IA: - Conta do ChatGPT - [OpenAI](https://platform.openai.com/api-keys) - [Anthropic](https://console.anthropic.com/account/keys) - [DeepSeek](https://platform.deepseek.com/settings) - [Gemini](https://makersuite.google.com/app/apikey) - [OpenRouter](https://openrouter.ai/keys) - **Controles de parâmetros musicais:** Ajuste tonalidade, escala, tipo de notação e muito mais. - **Compatibilidade entre plataformas:** Disponível como plugin VST3 para Windows e macOS, além de AU, AAX e aplicativo independente nas plataformas compatíveis. - **Tema claro ou escuro:** Escolha a aparência que preferir. ## Interface e controles ### Configurações de IA - **Seleção de provedor:** Escolha entre vários provedores de IA - **Seleção de modelo:** Escolha modelos de IA específicos - **Acesso:** Conecte ChatGPT, chaves de provedores, LLMs locais ou Pro ### Parâmetros musicais - Seleção de tonalidade - Seleção de escala - Tipo de notação - Duração das notas - Duração (compassos) - Gênero ## Fluxo de trabalho e uso O MIDI Agent foi desenvolvido para se integrar ao seu fluxo de trabalho na DAW: 1. Instale o plugin VST na sua DAW 2. Escolha uma conta do ChatGPT, uma chave de API de provedor, um LLM local ou MIDI Agent Pro 3. Crie uma faixa MIDI e adicione o plugin MIDI Agent 4. Use a interface do plugin para gerar ou modificar MIDI 5. Arraste o MIDI gerado para um canal da sua DAW ou salve-o nos seus arquivos ## Boas práticas ### Como escrever boas instruções para gerar música - Dê orientações musicais específicas - Descreva padrões de notas e ritmos, por exemplo: “alterne notas longas sustentadas com passagens rápidas em staccato” - Especifique o movimento melódico, por exemplo: “crie uma melodia que comece no grave, suba por dois tempos e depois volte a descer” - Inclua instruções rítmicas, por exemplo: “use ritmos sincopados com ênfase nos contratempos” - Defina elementos harmônicos, por exemplo: “use uma progressão I-vi-IV-V com acordes de sétima” ou “use 4 vozes em cada acorde” - Evite referências vagas a estilos ou gêneros; seja específico, como “power chords de guitarra elétrica em uma música de rock” ### Continuações e variações de MIDI - Use uma frase ou seção MIDI clara para estabelecer a harmonia e o ritmo - Descreva se deseja uma continuação, variação, resposta, virada ou transição - Escolha uma duração de geração adequada à parte que está criando - Gere novamente, combine e edite os melhores resultados na sua DAW - Experimente diferentes instruções e parâmetros para descobrir o que funciona melhor com seu arquivo de entrada ### Boas práticas de conversão de áudio para MIDI Para obter os melhores resultados de transcrição: - Use gravações de áudio de alta qualidade - Garanta uma boa separação entre os instrumentos, com pouco vazamento e reverberação - Para melhores resultados, use arquivos com menos de 30 segundos e tamanho reduzido - Funciona melhor com: - Gravações de piano solo - Gravações de guitarra limpa - Gravações multipista com boa separação - Instrumentos acústicos com poucos efeitos - Evite ou use com cuidado: - Áudio muito processado ou distorcido - Gravações ao vivo com muito ruído ambiente - Peças orquestrais complexas com muitas partes sobrepostas - Áudio com muita compressão ou limitação ### Dicas gerais - **Use os modelos mais capazes disponíveis** — recomendamos os modelos mais recentes da Anthropic (Claude) e do Google (Gemini) para obter os melhores resultados - **Adapte ao seu gênero** — experimente instruções personalizadas para seu estilo musical no painel de configurações - **Forneça exemplos** — adicione arquivos MIDI de exemplo do seu gênero ou das suas preferências nas configurações para orientar os resultados de tarefas específicas - **Inicie novas conversas com frequência** — históricos longos podem acumular contexto desatualizado e prejudicar o desempenho do modelo - **Divida tarefas complexas** — separe tarefas grandes em etapas menores, gere uma parte por vez e avalie cada resultado antes de continuá-lo ## Solução de problemas ### Problemas comuns #### Problemas de conexão com a API - Confira se sua chave de API foi inserida corretamente nas configurações - Verifique sua conexão com a internet - Confirme que você tem créditos de API suficientes #### O plugin não carrega - Confira se instalou o formato VST3, AU, AAX ou aplicativo independente adequado ao seu fluxo de trabalho - Faça uma nova busca na pasta de plugins - Confira se seu sistema atende aos requisitos mínimos - Se não usa uma DAW, abra o aplicativo independente: menu Iniciar no Windows ou /Applications/MIDI Agent.app no macOS #### Usuários do Pro Tools (AAX) - Confirme que o plugin AAX está instalado em C:\Program Files\Common Files\Avid\Audio\Plug-Ins (Windows) ou /Library/Application Support/Avid/Audio/Plug-Ins (macOS) - Reabra o Pro Tools e aguarde a conclusão da busca inicial de plugins - O MIDI Agent aparece nas faixas de instrumento #### Fluxo de trabalho do aplicativo independente - O aplicativo independente permite gerar MIDI sem uma DAW - Arraste o arquivo .mid gerado diretamente para a linha do tempo ou uma faixa MIDI de qualquer DAW - Se a DAW não aceitar arrastar e soltar diretamente, use Salvar MIDI - O andamento e o transporte usam os padrões do MIDI Agent; não há cursor de reprodução de uma DAW #### Problemas de compatibilidade com o macOS - Versões antigas do macOS podem ter dificuldade para reconhecer o plugin; atualize para a versão mais recente do macOS - Se instalou as versões AU e VST3 e o plugin não aparece, tente instalar apenas um formato - Algumas DAWs no macOS podem apresentar conflitos quando os dois formatos estão presentes #### Usuários do Logic Pro - O plugin fica no slot MIDI FX, acima dos slots de instrumento e efeitos de áudio na faixa de canal de um instrumento de software #### Migrar para o MIDI Agent Pro - Se você migrar para o MIDI Agent Pro com o plugin aberto, reinicie-o para que a assinatura seja reconhecida #### Problemas de geração de MIDI - Tente usar instruções mais específicas - Ajuste a temperatura e outros parâmetros - Confira se sua instrução segue as boas práticas #### Problemas de conversão de áudio para MIDI - Use gravações de áudio de alta qualidade - Confirme que o áudio não está saturando - Tente processar um instrumento por vez ### Mensagens de erro #### “Chave de API inválida” Confira sua chave de API no painel de configurações. Verifique se não há espaços extras. #### “Limite de solicitações excedido” Aguarde alguns minutos e tente novamente, ou mude para um plano de API com limites maiores. #### “Falha na geração” Tente ajustar sua instrução ou os parâmetros. Se o problema persistir, confira o status da API. ### Obter ajuda Se você ainda estiver com problemas: - Confira se há atualizações na nossa documentação - Fale conosco pelo formulário de contato - Inclua informações detalhadas sobre sua configuração e o problema ![MIDI Agent](https://www.midiagent.com/midi-agent-icon-black-bg.jpeg?v=20260623) Escrito por [MIDI Agent](https://www.midiagent.com/pt-br/sobre) / Última atualização 11 de outubro de 2026 / O MIDI Agent desenvolve ferramentas de IA para produtores musicais, compositores e beatmakers que querem gerar ideias musicais dentro da DAW. Traduzido do conteúdo original em inglês do MIDI Agent para facilitar o acesso em português brasileiro. [Ver o original em inglês.](https://www.midiagent.com/docs)