openclip-ugc-ads

OpenClip: Geração de anúncios UGC

generate_ugc renderiza um clipe vertical curto no estilo UGC (aproximadamente 7 a 12 segundos) a partir de um brief criativo. Contas gratuitas têm UMA geração por dia. Contas pagas são medidas em créditos por segundos renderizados.

As renderizações são pesadas. Espere alguns minutos por clipe, não segundos.

Configuração (uma vez)

OpenClip é um servidor MCP remoto em https://openclip.app/mcp. Faça login com sua conta OpenClip quando o prompt OAuth aparecer, não há chave de API para copiar.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, depois /mcp para autorizar.
• Claude Desktop / web: Configurações, Conectores, "Adicionar conector personalizado", cole a URL, faça login.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clientes apenas com cabeçalho: gere um token MCP em openclip.app/settings/connect e conecte-se a https://openclip.app/mcp/key com Authorization: Bearer <token>.

Teste rápido: chame get_account.

O ciclo

1. Descubra o elenco PRIMEIRO. list_ugc_creators retorna os valores válidos de creator e start_frame para esta equipe: um elenco selecionado mais os criadores salvos pela própria equipe, agrupados por nicho. Nunca adivinhe um nome de criador, escolha um a partir desta chamada.
2. Gere. generate_ugc(...) com:
   • brief_name - um preset no lado do servidor, o caminho rápido, ou
   • brief - um objeto inline com campos criativos estruturados (character e outros).
3. Monitore. Retorna um hashid ugc_job. Consulte get_ugc_job_status(ugc_job) a cada 10 a 15 segundos. queued / rendering indicam processamento. completed retorna video_url mais result_meta (duração, dimensões, fps, seed). failed retorna error.
4. Revise trabalhos anteriores. list_ugc_jobs lista os clipes UGC anteriores de uma equipe, e é como você encontra um id ugc_job para monitorar se o perdeu.

O brief é estruturado, não é um prompt

Isso é o que os agentes mais erram. brief não é um prompt em prosa. É um objeto com campos criativos discretos (character e outros campos que a API aceita). Escrever um parágrafo em um único campo desperdiça a estrutura e produz resultados genéricos.

Escreva cada campo como um detalhe concreto, físico e filmável:

• Nomeie o que está no quadro, não como deve parecer. "Segurando a garrafa na altura do peito, bancada da cozinha atrás" é melhor que "vibrações enérgicas e aspiracionais".
• Uma ideia por campo. Não empilhe três batidas em character.
• Restrições produzem resultados melhores que adjetivos. Um cenário específico, um adereço específico e uma ação específica vencem "alta qualidade, profissional, envolvente".

Testando ângulos de anúncios

Quando o usuário quiser variações em vez de um único clipe, altere UMA variável por renderização para que a comparação faça sentido:

• Mesmo criador, gancho diferente.
• Mesmo gancho, criador diferente, quando você estiver testando quem transmite melhor a mensagem.
• Mesmo tudo, start_frame diferente, quando você estiver testando o momento da miniatura.

Contas gratuitas têm uma geração por dia, então, em uma conta gratuita, use-a no ângulo mais diferente, em vez de um quase duplicado. Verifique get_account antes de prometer um lote.

Regras

• list_ugc_creators antes de cada primeira geração em uma sessão. O elenco é específico da equipe e muda.
• Sempre monitore. As renderizações levam minutos, generate_ugc retorna imediatamente.
• Clipes são curtos por design, aproximadamente 7 a 12 segundos. Não prometa um anúncio de 60 segundos.
• Nível gratuito é UMA geração por dia. Avise antes de o usuário planejar um lote em uma conta gratuita.
• result_meta inclui o seed. Guarde-o quando o usuário gostou de uma renderização e quiser uma variante próxima.

Erros

Falhas de ferramenta retornam como resultado da ferramenta com isError: true e uma mensagem de texto simples, não um status HTTP. "Não autenticado. Reconecte seu token OpenClip." significa reconectar ou gerar novamente o token. Mensagens de validação (um criador desconhecido, um brief malformado) retornam como texto da mensagem, corrija o argumento e tente novamente.

Exemplos de prompts para ações

• "Crie um anúncio UGC para meu aplicativo" - list_ugc_creators, escolha um criador adequado, generate_ugc(brief={...}), monitore get_ugc_job_status, retorne video_url.
• "Me dê três ângulos para testar" - uma renderização por ângulo, uma variável alterada de cada vez, monitore cada um. Verifique o limite diário primeiro em uma conta gratuita.
• "Use a mesma garota de antes" - list_ugc_jobs para encontrar o trabalho anterior, leia seu criador, reutilize-o.
• "Quais criadores posso usar?" - list_ugc_creators, mostre-os agrupados por nicho.

Relacionados

Cortar vídeos longos em curtos é openclip-clipping. Corte, redimensionamento e compressão gratuitos do clipe gerado são openclip-video-editing.