Google Vids MCP Server by useapi.net

Google Vids: vídeo Omni do Gemini com som, avatares com voz, extensão, upscale, edição, imagens. Terceirizado, pago (US$ 15/mês), roda na sua própria conta.

Ver em useapi.net

Servidor MCP hospedado

npx add-mcp 'https://api.useapi.net/v1/google-vids/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Google Vids MCP Server

16 de outubro de 2026

O servidor MCP Google Vids da useapi.net permite que um assistente de IA, como Claude Code, Cursor ou VS Code Copilot, crie vídeos com o Google Vids nas suas próprias contas do Google. É um servidor hospedado do Model Context Protocol com 16 ferramentas: gerar clipes Gemini Omni 1.1 Flash com som e fala a partir de texto, de uma imagem inicial ou de até 3 referências, estender, aumentar a resolução e editar clipes, criar imagens, enviar suas próprias fotos e criar avatares com voz que falam os textos que você escreve. Cada ferramenta chama a API do Google Vids, portanto as mesmas regras e limites se aplicam. Nada precisa ser instalado ou hospedado.

Existe um servidor MCP do Google Vids? Sim. A useapi.net, um serviço de terceiros não afiliado ao Google, hospeda um em https://api.useapi.net/v1/google-vids/mcp com 16 ferramentas para vídeo, imagens e avatares com voz do Gemini Omni 1.1 Flash, no seu próprio plano Google AI Pro ou Ultra, sem necessidade de instalação.

Prefere REST? Tutorial: Como criar vídeos de influenciadores de IA com avatares via API do Google Vids · Código: github.com/useapi/google-vids-api

Veja todos os servidores MCP da useapi.net em Model Matrix & MCP.

Endpoint e autorização

https://api.useapi.net/v1/google-vids/mcp

Transporte: HTTP Streamable.
Listado no Registro oficial de MCP como net.useapi/google-vids, para que clientes e diretórios MCP que leem o registro possam encontrá-lo por esse nome.
Autorização: seu token de API da useapi.net no cabeçalho Authorization: Bearer …, consulte Configurar useapi.net.
Você precisa de pelo menos uma conta do Google adicionada com Configurar Google Vids. Adicionar e remover contas não está disponível via MCP: use POST /accounts ou a página de configuração.

Configuração

Substitua YOUR_API_TOKEN pelo seu token de API da useapi.net.

Claude Code

claude mcp add --transport http useapi-google-vids https://api.useapi.net/v1/google-vids/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "useapi-google-vids": {
      "url": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

Em .vscode/mcp.json:

{
  "servers": {
    "useapi-google-vids": {
      "type": "http",
      "url": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Windsurf e outros clientes

Qualquer cliente que suporte servidores MCP remotos via HTTP com cabeçalhos personalizados funciona. O formato JSON usual:

{
  "mcpServers": {
    "useapi-google-vids": {
      "serverUrl": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Alguns clientes nomeiam o campo de endereço como url em vez de serverUrl.

Teste com curl

curl -s https://api.useapi.net/v1/google-vids/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -s https://api.useapi.net/v1/google-vids/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

A primeira chamada responde com o nome do servidor useapi-google-vids e suas instruções para o assistente; a segunda, com as 16 ferramentas.

Ferramentas

Clipes, imagens, envios e avatares são nomeados pelos IDs que as ferramentas retornam, e cada ID carrega sua conta, então uma ação de acompanhamento é executada na conta que contém suas entradas. Ferramentas que iniciam um trabalho aceitam um email opcional para escolher a conta.

Contas

Ferramenta	O que faz	Principais parâmetros
`vids_list_accounts`	Lista suas contas com status de saúde, `maxJobs` e os limites mensais do plano.
`vids_get_account`	Verifica uma conta ao vivo: conectada ou não, e o que resta dos segundos de vídeo e imagens deste mês.	`email`
`vids_update_account`	Define `maxJobs`, os trabalhos que uma conta executa por vez.	`email`, `maxJobs`

Vídeos e imagens

Ferramenta	O que faz	Principais parâmetros
`vids_create_video`	Gera um clipe de 3 a 10 segundos com som e fala a partir de texto, de uma imagem inicial ou de até 3 referências (imagens e avatares, nomeados no prompt como `@referenceImage_1` ou `@avatar_1`).	`prompt`, `duration`, `aspectRatio`, `resolution`, `startImage`, `referenceImage_1`..`3`, `avatar_1`..`3`, `email`
`vids_extend_video`	Adiciona 3 a 10 segundos a um clipe e retorna o clipe completo, até cerca de 41 segundos.	`mediaId`, `prompt`, `duration`
`vids_upscale_video`	Transforma um clipe `720p` de até 20 segundos em `1080p`.	`mediaId`
`vids_edit_video`	Altera um clipe por prompt: cores, objetos, estilo.	`video`, `prompt`, `duration`
`vids_create_image`	Gera um JPEG em um dos 7 estilos, retornado como uma imagem que o assistente pode ver.	`prompt`, `aspectRatio`, `style`, `email`
`vids_get_job`	Lê um trabalho e, com `wait: true`, aguarda sua conclusão.	`jobid`, `wait`
`vids_list_jobs`	Lista os trabalhos em execução agora e a contagem em execução de cada conta em relação a `maxJobs`.

Os parâmetros correspondem a POST /videos, POST /videos/extend, POST /videos/upscale, POST /videos/edit e POST /images.

Arquivos, avatares e vozes

Ferramenta	O que faz	Principais parâmetros
`vids_upload_asset`	Envia sua própria imagem JPEG, PNG ou WebP a partir de uma URL https pública de até 50 MB, ou enviada como `contentBase64`, e retorna um `assetId` para `startImage` ou `referenceImage_N`.	`url` ou `contentBase64`, `mimeType`, `email`
`vids_get_media`	Verifica um `mediaId` e retorna sua URL de download. Uma imagem também volta como uma imagem que o assistente pode ver.	`mediaId`
`vids_list_voices`	Lista as 30 vozes do Gemini com seu estilo e áudio de prévia.
`vids_list_avatars`	Lista os avatares salvos nas suas contas, incluindo os criados no aplicativo web do Google Vids.	`email`
`vids_create_avatar`	Cria um avatar com voz a partir de uma descrição da pessoa (`appearance`), que usa 1 imagem da cota da conta, ou a partir de uma imagem criada com `vids_create_image`. Um avatar desenhado volta como uma imagem.	`name`, `voice`, `appearance`, `outfit`, `shot`, `expression`, `details`, `image`, `email`
`vids_delete_avatar`	Exclui um avatar.	`avatarId`

O esquema completo de entrada de cada ferramenta vem de tools/list.

Trabalhos de longa duração

Clientes MCP geralmente desistem de uma chamada de ferramenta após cerca de um minuto, então uma ferramenta aguarda até cerca de 50 segundos:

Uma imagem geralmente termina em cerca de 10 segundos, e a ferramenta a retorna.
Um clipe 720p geralmente termina nesse tempo. Um clipe 1080p, uma extensão, um aumento de resolução ou uma edição leva mais tempo. A ferramenta então retorna o jobid, e vids_get_job com wait: true o retoma. Peça ao assistente para continuar verificando até que esteja concluído.
vids_create_avatar responde em cerca de 10 a 40 segundos.

Clientes que solicitam notificações de progresso recebem uma a cada cerca de 10 segundos enquanto uma ferramenta aguarda.

Os clipes voltam como um mediaId com uma URL de download. Busque-o com o mesmo cabeçalho Authorization e baixe logo, pois o Google mantém os arquivos apenas por um tempo, consulte Por quanto tempo os arquivos duram.

Exemplos de prompts

"Crie um clipe de 10 segundos em 1080p de uma raposa correndo por uma floresta nevada ao amanhecer."
"Crie uma foto de uma bicicleta vermelha em uma rua de Lisboa e depois transforme-a em um clipe onde alguém a pedalando vai embora."
"Crie um avatar de uma chef alegre na casa dos cinquenta com a voz Neo e depois faça um clipe de retrato onde ela diz: 'Hoje assamos pão.'"
"Envie esta foto do produto e faça um clipe do meu avatar segurando-a e falando sobre ela."
"Estenda o último clipe em 8 segundos com a câmera recuando e depois aumente a resolução para 1080p."
"Quantos segundos de vídeo restam nas minhas contas do Vids neste mês?"

Limites e observações

As ferramentas usam suas contas do Google e as mesmas regras da API REST, como maxJobs. Segundos de vídeo e imagens contam contra a cota mensal de Vids da conta, consulte Planos e cotas mensais.
Conectores personalizados no claude.ai exigem login OAuth, que este servidor ainda não suporta. Use Claude Code ou outro cliente que possa enviar um cabeçalho Authorization.
Um cliente pode enviar até 20 solicitações JSON-RPC em um único lote.
Se o cliente enviar um cabeçalho MCP-Protocol-Version, ele deve ser uma das versões suportadas: 2025-06-18, 2025-03-26 ou 2024-11-05.
Cada chamada de ferramenta aparece nas suas estatísticas de uso ( bot=google-vids) como modelo mcp, com o nome da ferramenta como status, ou failed.

Tutoriais para a API do Google Vids v1:

{ "@context": "https://schema.org", "@type": "APIReference", "name": "Google Vids MCP Server: Gemini Omni Video and Voiced Avatars", "url": "https://useapi.net/docs/api-google-vids-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net Google Vids MCP server: 16 tools for Omni 1.1 Flash video, images and voiced avatars.", "about": "Google Vids API v1", "isPartOf": { "@type": "APIReference", "name": "Google Vids API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "Google Vids API v1", "item": "https://useapi.net/docs/api-google-vids-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-google-vids-v1/mcp" } ] }