Documentação
API e MCP da DevX Viral
Uma chave criada no painel dá à sua IA, ou ao seu sistema, o mesmo acesso que você tem, dentro do papel e do plano.
1. Crie uma chave
No painel, em Definições → Chaves de API, dê um nome e escolha o papel. A chave aparece uma vez só: copie e guarde. Ela começa com dvx_.
2. Conecte pelo MCP
O servidor fica em https://api.devxviral.com/mcp, com transporte HTTP. No Claude Code:
claude mcp add --transport http devxviral https://api.devxviral.com/mcp \ --header "Authorization: Bearer dvx_SUA_CHAVE"
No Cursor (ou em qualquer cliente que aceite servidor por URL):
{
"mcpServers": {
"devxviral": {
"url": "https://api.devxviral.com/mcp",
"headers": { "Authorization": "Bearer dvx_SUA_CHAVE" }
}
}
}O painel mostra esses comandos prontos, com a sua chave, também para o Claude Desktop.
3. Ou chame a API direto
As rotas ficam em https://api.devxviral.com/api/… e aceitam a mesma chave no cabeçalho. A chave age como quem a criou, no workspace dela, com o papel escolhido.
curl https://api.devxviral.com/api/accounts \ -H "Authorization: Bearer dvx_SUA_CHAVE"
Cobrança e indicações são só leitura pela chave; as chaves e a administração não aceitam chave nenhuma.
Limites por plano
| Plano | Chamadas por minuto | Chaves | Acesso |
|---|---|---|---|
| Essencial | 60 | 3 | Leitura |
| Pro | 120 | 5 | Leitura e escrita |
| Agência | 300 | 40 | Leitura e escrita |
Algumas ferramentas que custam processamento (ver quadro, exportar, transcrever, buscar referências, enviar e importar) têm também um teto por dia no workspace.
Papéis da chave
adminTudo: ver, publicar, vídeos, contas, membros e definições.editorVer, publicar, mexer em vídeos e contas. Sem definições nem cobrança.analistaSó ler.
A chave nunca tem papel acima de quem a criou.
Erros
- 401
unauthorizedFaltou o cabeçalho Authorization, ou a chave foi revogada. - 402
feature_not_in_planO plano não libera a API, ou a ação escreve e o plano só lê. - 403
forbiddenO papel da chave não pode fazer essa ação. - 429
rate_limitedPassou das chamadas por minuto. Espere o tempo do cabeçalho Retry-After.
As ferramentas do MCP
As principais. As marcadas com E escrevem e pedem o Pro ou o Agência; as com E! apagam ou cancelam e pedem confirmar: true.
Conta e painel
quem_sou_euQuem é a chave, qual workspace e qual plano.listar_contasAs páginas conectadas, com busca e filtro por rede.ver_saude_das_contasSaúde, entrega e alertas de cada página.ver_painelOs números do painel por período, rede ou página.melhores_horariosOs horários em que as suas páginas rendem mais.listar_reelsOs reels publicados, ordenados por viralidade.ver_rankingO ranking da semana, do mês ou geral.buscar_referenciasReels de referência por nicho ou perfil.
Biblioteca e envio
listar_bibliotecaVídeos, imagens e áudios, com pastas e busca.enviar_arquivoE Envia um arquivo do seu computador.importar_por_urlE Traz um vídeo de um link direto, do YouTube ou do Google Drive.buscar_imagensBusca imagens livres para usar no vídeo.criar_pastaE Cria uma pasta na biblioteca.mover_para_pastaE Organiza vídeos em pastas.gerar_variacoesE Gera versões diferentes de um vídeo.importar_reelE Traz um reel publicado para a biblioteca.
Publicar e agendar
agendar_publicacaoE Um vídeo numa página, num horário.agendar_loteE Vários vídeos em várias páginas, com intervalo e variação por conta.agendar_storiesE Stories em sequência nas páginas.agendar_fotoE Foto ou carrossel no feed.ver_agendaO que está agendado, publicado ou falhou.repetir_publicacaoE Tenta de novo o que falhou.cancelar_publicacaoE! Cancela publicações ou um lote inteiro.criar_rotina_de_storiesE Stories todo dia, sozinhos, a partir de uma pasta.
Cortes e legendas
gerar_cortesE Transforma um vídeo longo em cortes prontos no editor.status_dos_cortesAcompanha a geração dos cortes.transcreverE Transcreve a fala de um projeto.gerar_legendasE Legendas com estilo, posição e destaque.
Editor
criar_projetoE Abre um projeto com os vídeos escolhidos.descrever_projetoO que tem no projeto: trechos, textos, sons.ver_quadroA imagem de um segundo do vídeo, para a IA conferir.remover_pausasE Corta os silêncios da fala.dividir_clipe / aparar_clipeE Corta e ajusta os trechos.adicionar_clipeE Põe um vídeo na linha do tempo, inclusive como B-roll.adicionar_textoE Título, legenda ou destaque, com estilo e tempo.adicionar_audioE Música ou efeito sonoro.definir_transicaoE Transição entre trechos.aplicar_efeitos_de_videoE Filtro, cor e movimento.animarE Animação por quadros-chave em textos e trechos.aplicar_formatoE Aplica um formato salvo (moldura, textos fixos).seguir_rostoE Câmera que acompanha o rosto.separar_vozE Separa a voz da música.desfazerE Desfaz a última ação da IA.exportarE Gera o vídeo final na biblioteca.