convez.ai
SkillMarketing & VendasIntermediário
Jarad-z

UGC Video Prompt

Jarad-z/ugc-video-prompt

Gera e renderiza prompts de vídeo UGC via APIs de modelos de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que gera prompts otimizados para vídeos UGC (User-Generated Content) em produção e os renderiza via APIs oficiais de modelos de IA (Sora, Kling, Veo, Seedance, Hailuo). Especializado em criar roteiros que parecem filmados autenticamente por usuários reais, com micro-tremores, iluminação natural e diálogo casual.

Instalação

$npx convez-ai Jarad-z/ugc-video-prompt

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar campanhas de marketing com vídeos de conteúdo gerado por usuários
  • Produzir roteiros para demonstração de produtos de forma autêntica
  • Gerar múltiplas variações de vídeo UGC automaticamente para A/B testing

Veredito

Ferramenta robusta e bem-arquitetada para automação end-to-end de vídeos UGC, integrando cinco APIs maiores e focando na qualidade essencial: prompts que geram vídeos com aparência genuína. Código maduro com suporte multi-vendor e documentação clara; ideal para equipes de marketing que precisam escalar produção de conteúdo.

README

A tradução para o português deste README ainda está na fila.

ugc-video-prompt

A Claude skill that writes production-ready prompts for AI video models — and can call the vendors' official APIs to render the actual .mp4 end to end.

The goal is a clip that looks like a real person filmed it on their phone — handheld micro-shake, natural daylight, real skin, casual self-aware dialogue — not a polished ad. That "authentic amateur" quality is what makes UGC spread, and it comes almost entirely from how the prompt is written.

Supported models

Each path targets the vendor's official API (not a reseller):

ModelVendorNative audioReference image
Seedance 即梦Volcengine / BytePlus ModelArk—first-frame image
Kling 可灵Kuaishou (api.klingai.com)version-dependentElements / dual-image (Omni)
Veo 3Google Gemini API✅separate image inputs
SoraOpenAI /v1/videos✅—
Hailuo 海螺MiniMax—image input

A verified Kling Omni dual-image path locks both a person photo and a product photo to their originals at once — the API equivalent of 即梦's @图1 @图2.

What's in here

SKILL.md            The skill itself — prompt-engineering craft + per-model workflow
references/         Per-model API notes (dialogue syntax, audio, params, asset refs)
scripts/generate.py Multi-vendor renderer: submit prompt + images, poll, download
scripts/README.md   How to run the renderer
evals/evals.json    Evaluation cases (EN + 中文)

Using the renderer

Credentials are read from environment variables — never hard-coded.

pip install requests pyjwt

# set keys for whichever model you use:
#   seedance : ARK_API_KEY
#   kling    : KLING_ACCESS_KEY, KLING_SECRET_KEY
#   hailuo   : MINIMAX_API_KEY, MINIMAX_GROUP_ID
#   veo      : GEMINI_API_KEY
#   sora     : OPENAI_API_KEY

python scripts/generate.py \
  --model veo --prompt-file prompt.txt --out out.mp4 \
  --aspect 9:16 --duration 8

--image / --image-tail accept either a local file path or an http(s) URL. See scripts/README.md for the full reference.

Installing as a Claude skill

Clone into your skills directory so Claude Code can discover it:

git clone https://github.com/Jarad-z/ugc-video-prompt.git ~/.claude/skills/ugc-video-prompt

Then ask for a UGC video prompt (or just hand Claude a product photo and a model name) and the skill triggers automatically.

License

MIT

Ver o original no GitHub

Bom para

Relacionados