Skill de Geração de Vídeo Sora
Cria ou gerencia clipes de vídeo curtos para o projeto atual (demonstrações de produto, anúncios de marketing, tomadas cinematográficas, maquetes de UI). Usa como padrão sora-2 e um fluxo de trabalho de aumento de prompt estruturado, e prefere a CLI fornecida para execuções determinísticas. Nota: $sora é uma tag de skill em prompts, não um comando de shell.
Quando usar
- Gerar um novo clipe de vídeo a partir de um prompt
- Remixar um vídeo existente por ID
- Consultar status, listar tarefas ou baixar ativos (vídeo/thumbnail/spritesheet)
- Execuções em lote (muitos prompts ou variantes)
Árvore de decisão (criar vs remixar vs status/download vs lote)
- Se o usuário tem um id de vídeo e quer uma alteração → remix
- Se o usuário tem um id de vídeo e quer status ou ativos → status/poll/download
- Se o usuário precisa de muitos prompts/ativos → create-batch
- Se o usuário pedir duas versões com uma pequena alteração (mesmo plano, diferente assunto/detalhe) → create o base, depois remix para a variação
- Caso contrário → create (ou create-and-poll se precisar de um ativo pronto em uma etapa)
Fluxo de trabalho
- Decidir a intenção: criar vs remixar vs status/download vs lote.
- Coletar entradas: prompt, modelo, tamanho, segundos e qualquer imagem de referência de entrada.
- Se for lote: escrever um JSONL temporário em
tmp/(uma tarefa por linha), executar uma vez e depois excluir o JSONL. - Preferir flags de aumento da CLI (
--use-case,--scene,--camera, etc.) em vez de pré-escrever um prompt estruturado. Se você já produziu um arquivo de prompt estruturado, passe--no-augmentpara evitar o dobramento duplo. - Executar a CLI fornecida (
scripts/sora.py) com padrões sensatos (consultereferences/cli.md). Para prompts longos, prefira--prompt-filepara evitar problemas de escape de shell; combine com--no-augmentse o prompt já estiver estruturado. - Para tarefas assíncronas, consultar até a conclusão (ou usar
create-and-poll). - Baixar ativos (vídeo/thumbnail/spritesheet) e salvar localmente.
- Remover arquivos intermediários criados durante a invocação (por exemplo,
prompt.txt,remix_job.json, JSONL temporário). Se o sandbox bloquearrm, pule a limpeza ou trunque os arquivos sem exibir um erro. - Iterar com uma única alteração direcionada por prompt.
Autenticação
OPENAI_API_KEYdeve estar definida para chamadas de API reais.
Se a chave estiver faltando, forneça ao usuário estas etapas:
- Criar uma chave de API na interface do OpenAI platform: https://platform.openai.com/api-keys
- Definir
OPENAI_API_KEYcomo uma variável de ambiente no sistema. - Oferecer-se para orientá-los na definição da variável de ambiente para seu SO/shell, se necessário.
- Nunca peça ao usuário para colar a chave completa no chat. Peça para defini-la localmente e confirmar quando estiver pronto.
Padrões & regras
- Modelo padrão:
sora-2(usesora-2-propara maior fidelidade). - Tamanho padrão:
1280x720. - Segundos padrão:
4(permitido: "4", "8", "12" como strings). - Sempre defina tamanho e segundos via parâmetros da API; o texto em prosa não os alterará.
- Usar o SDK Python da OpenAI (
openaipacote); não usar HTTP bruto. - Exigir
OPENAI_API_KEYantes de qualquer chamada de API real. - Se as permissões do cache do uv falharem, definir
UV_CACHE_DIR=/tmp/uv-cache. - Imagens de referência de entrada devem ser jpg/png/webp e devem corresponder ao tamanho alvo.
- As URLs de download expiram após cerca de 1 hora; copie os ativos para seu próprio armazenamento.
- Preferir a CLI fornecida e nunca modificar
scripts/sora.pya menos que o usuário solicite. - Sora pode gerar áudio; se um usuário solicitar narração/áudio, especifique-o explicitamente nas linhas
Audio:eDialogue:e mantenha curto.
Limitações da API
- Os modelos são limitados a
sora-2esora-2-pro. - O acesso à API aos modelos Sora requer uma conta verificada pela organização.
- A duração é limitada a 4/8/12 segundos e deve ser definida através do parâmetro
seconds. - A API espera
secondscomo uma enumeração de string ("4", "8", "12"). - Os tamanhos de saída são limitados por modelo (consulte
references/video-api.mdpara os tamanhos suportados). - A criação de vídeo é assíncrona; você deve consultar até a conclusão antes de baixar.
- Os limites de taxa se aplicam por nível de uso (não liste limites específicos).
- Restrições de conteúdo são aplicadas pela API (veja Guardrails abaixo).
Guardrails (deve aplicar)
- Apenas conteúdo adequado para audiências menores de 18 anos.
- Nenhum personagem com direitos autorais ou música com direitos autorais.
- Nenhuma pessoa real (incluindo figuras públicas).
- Imagens de entrada com rostos humanos são rejeitadas.
Aumento de prompt
Reformate prompts em uma especificação estruturada e orientada à produção. Torne explícitos apenas os detalhes implícitos; não invente novos requisitos criativos.
Template (incluir apenas linhas relevantes):
Use case: <onde o clipe será usado>
Primary request: <prompt principal do usuário>
Scene/background: <local, hora do dia, atmosfera>
Subject: <assunto principal>
Action: <ação clara única>
Camera: <tipo de plano, ângulo, movimento>
Lighting/mood: <iluminação + clima>
Color palette: <3-5 âncoras de cor>
Style/format: <dicas de filme/animação/formato>
Timing/beats: <contagens ou batidas>
Audio: <dica ambiente / música / narração se solicitado>
Text (verbatim): "<texto exato>"
Dialogue:
<diálogo>
- Speaker: "Frase curta."
</dialogue>
Constraints: <deve manter / deve evitar>
Avoid: <restrições negativas>
Regras de aumento:
- Mantenha curto; adicione apenas detalhes que o usuário já implícito ou fornecido em outro lugar.
- Para remixes, liste explicitamente os invariantes ("mesmo plano, mude apenas X").
- Se algum detalhe crítico estiver faltando e bloquear o sucesso, faça uma pergunta; caso contrário, prossiga.
- Se você passar um arquivo de prompt estruturado para a CLI, adicione
--no-augmentpara evitar que a ferramenta o reembrulhe.
Exemplos
Exemplo de geração (plano único)
Use case: teaser de produto
Primary request: close-up de uma câmera preta fosca em um pedestal
Action: órbita lenta de 30 graus ao longo de 4 segundos
Camera: 85mm, profundidade de campo rasa, deriva suave de mão
Lighting/mood: luz chave suave, rim sutil, sensação premium de estúdio
Constraints: sem logotipos, sem texto
Exemplo de remix (invariantes)
Primary request: mesmo plano e enquadramento, mude a paleta para teal/sand/rust com luz de fundo mais quente
Constraints: mantenha o assunto e o movimento da câmera inalterados
Melhores práticas para prompts (lista curta)
- Uma ação principal + um movimento de câmera por plano.
- Use contagens ou batidas para temporização ("dois passos, pausa, vire").
- Mantenha o texto curto e a câmera fixa para UI ou texto na tela.
- Adicione uma breve linha de "evitar" quando artefatos aparecerem (cintilação, trepidação, movimento rápido).
- Prompts mais curtos são mais criativos; prompts mais longos são mais controlados.
- Coloque diálogo em um bloco dedicado; mantenha as falas curtas para clipes de 4-8s.
- Declare invariantes explicitamente para remixes (mesmo plano, mesmo movimento de câmera).
- Itere com acompanhamentos de alteração única para preservar a continuidade.
Orientação por tipo de ativo
Use estes módulos quando a solicitação for para um artefato específico. Eles fornecem modelos e padrões direcionados.
- Tomadas cinematográficas:
references/cinematic-shots.md - Anúncios sociais:
references/social-ads.md
Notas sobre CLI + ambiente
- Comandos e exemplos da CLI:
references/cli.md - Referência rápida de parâmetros da API:
references/video-api.md - Orientação sobre prompts:
references/prompting.md - Exemplos de prompts:
references/sample-prompts.md - Solução de problemas:
references/troubleshooting.md - Dicas de rede/sandbox:
references/codex-network.md
Mapa de referências
references/cli.md: como executar create/poll/remix/download/batch viascripts/sora.py.references/video-api.md: controles de nível de API (modelos, tamanhos, duração, variantes, status).references/prompting.md: estrutura de prompt e orientação de iteração.references/sample-prompts.md: receitas de prompt para copiar/colar (apenas exemplos; sem teoria extra).references/cinematic-shots.md: modelos para tomadas cinematográficas.references/social-ads.md: modelos para batidas curtas de anúncios sociais.references/troubleshooting.md: erros comuns e correções.references/codex-network.md: solução de problemas de rede/aprovação.