Skill de Geração de Vídeo Sora

Cria ou gerencia clipes de vídeo curtos para o projeto atual (demos de produto, spots de marketing, cenas cinematográficas, mockups de UI). Usa como padrão sora-2 e um fluxo estruturado de aumento de prompt, preferindo a CLI incluída para execuções determinísticas. Nota: $sora é uma tag de skill em prompts, não um comando 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 jobs ou baixar assets (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 video id e quer uma mudança → remix
Se o usuário tem um video id e quer status ou assets → status/poll/download
Se o usuário precisa de muitos prompts/assets → create-batch
Se o usuário pede duas versões com uma pequena mudança (mesmo shot, assunto/detalhe diferente) → create a base, depois remix para a variação
Caso contrário → create (ou create-and-poll se precisarem de um asset pronto em uma etapa)

Fluxo de trabalho

Decide a intenção: criar vs remixar vs status/download vs lote.
Colete inputs: prompt, modelo, tamanho, segundos e qualquer imagem de referência de entrada.
Se lote: escreva um JSONL temporário sob tmp/ (um job por linha), execute uma vez, depois delete o JSONL.
Prefira 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-augment para evitar dupla encapsulação.
Execute a CLI incluída (scripts/sora.py) com padrões sensatos (veja references/cli.md). Para prompts longos, prefira --prompt-file para evitar problemas de escape de shell; combine com --no-augment se o prompt já estiver estruturado.
Para jobs assíncronos, consulte até completar (ou use create-and-poll).
Baixe assets (vídeo/thumbnail/spritesheet) e salve localmente.
Remova arquivos intermediários criados durante a invocação (por exemplo prompt.txt, remix_job.json, JSONL temporário). Se a sandbox bloquear rm, pule a limpeza ou truncate os arquivos sem exibir um erro.
Itere com uma única mudança direcionada por prompt.

Autenticação

OPENAI_API_KEY deve estar definida para chamadas de API ativas.

Se a chave estiver faltando, forneça ao usuário estas etapas:

Crie uma chave de API na UI da plataforma OpenAI: https://platform.openai.com/api-keys
Defina OPENAI_API_KEY como uma variável de ambiente no seu sistema.
Ofereça orientação sobre como definir a 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 que a defina localmente e confirme quando estiver pronto.

Padrões e regras

Modelo padrão: sora-2 (use sora-2-pro para maior fidelidade).
Tamanho padrão: 1280x720.
Segundos padrão: 4 (permitidos: "4", "8", "12" como strings).
Sempre defina tamanho e segundos via parâmetros de API; prosa não os mudará.
Use o SDK Python da OpenAI (pacote openai); não use HTTP bruto.
Exija OPENAI_API_KEY antes de qualquer chamada de API ativa.
Se falhas de permissão de cache uv ocorrerem, defina UV_CACHE_DIR=/tmp/uv-cache.
Imagens de referência de entrada devem ser jpg/png/webp e devem corresponder ao tamanho alvo.
Download URLs expiram após cerca de 1 hora; copie assets para seu próprio armazenamento.
Prefira a CLI incluída e nunca modifique scripts/sora.py a menos que o usuário solicite.
Sora pode gerar áudio; se um usuário solicitar voiceover/áudio, especifique explicitamente nas linhas Audio: e Dialogue: e mantenha curto.

Limitações de API

Modelos limitados a sora-2 e sora-2-pro.
Acesso de API aos modelos Sora requer uma conta verificada pela organização.
A duração é limitada a 4/8/12 segundos e deve ser definida via parâmetro seconds.
A API espera seconds como enum de string ("4", "8", "12").
Os tamanhos de saída são limitados pelo modelo (veja references/video-api.md para tamanhos suportados).
Criação de vídeo é assíncrona; você deve consultar para conclusão antes de baixar.
Limites de taxa se aplicam por tier de uso (não liste limites específicos).
Restrições de conteúdo são aplicadas pela API (veja Guardrails abaixo).

Guardrails (deve-se executar)

Apenas conteúdo apropriado para públicos menores de 18 anos.
Sem personagens com direitos autorais ou música com direitos autorais.
Sem pessoas reais (incluindo figuras públicas).
Imagens de entrada com rostos humanos são rejeitadas.

Aumento de prompt

Reformate prompts em uma spec estruturada e orientada para produção. Apenas torne explícitos os detalhes implícitos; não invente novos requisitos criativos.

Template (inclua apenas linhas relevantes):

Caso de uso: <onde o clipe será usado>
Solicitação principal: <prompt principal do usuário>
Cena/background: <local, hora do dia, atmosfera>
Assunto: <assunto principal>
Ação: <ação única e clara>
Câmera: <tipo de shot, ângulo, movimento>
Iluminação/humor: <iluminação + humor>
Paleta de cores: <3-5 âncoras de cor>
Estilo/formato: <dicas de filme/animação/formato>
Timing/beats: <contagens ou beats>
Áudio: <dica ambiental / música / voiceover se solicitado>
Texto (verbatim): "<texto exato>"
Diálogo:
<diálogo>
- Personagem: "Linha curta."
</diálogo>
Restrições: <deve manter/deve evitar>
Evitar: <restrições negativas>

Regras de aumento:

Mantenha curto; adicione apenas detalhes que o usuário já implícita ou explicitamente forneceu em outro lugar.
Para remixes, liste explicitamente invariantes ("mesmo shot, 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-augment para evitar que a ferramenta o re-encapsule.

Exemplos

Exemplo de geração (single shot)

Caso de uso: teaser de produto
Solicitação principal: um close-up de uma câmera preta fosca em um pedestal
Ação: órbita lenta de 30 graus em 4 segundos
Câmera: 85mm, profundidade de campo rasa, drift handheld sutil
Iluminação/humor: soft key light, rim sutil, sensação premium de estúdio
Restrições: sem logos, sem texto

Exemplo de remix (invariantes)

Solicitação principal: mesmo shot e framing, trocar paleta para azul-petróleo/areia/ferrugem com contraluz mais quente
Restrições: manter o assunto e movimento de câmera inalterados

Melhores práticas de prompt (lista curta)

Uma ação principal + um movimento de câmera por shot.
Use contagens ou beats para timing ("dois passos, pausa, vira").
Mantenha texto curto e câmera travada para UI ou texto na tela.
Adicione uma linha breve de evitar quando artefatos aparecem (flicker, jitter, 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 linhas curtas para clipes de 4-8s.
Declare invariantes explicitamente para remixes (mesmo shot, mesmo movimento de câmera).
Itere com follow-ups de mudança única para preservar continuidade.

Orientação por tipo de asset

Use estes módulos quando a solicitação for para um artefato específico. Eles fornecem templates direcionados e padrões.

Shots cinematográficos: references/cinematic-shots.md
Anúncios sociais: references/social-ads.md

Notas de CLI e ambiente

Comandos de CLI + exemplos: references/cli.md
Referência rápida de parâmetros de API: references/video-api.md
Orientação de prompt: references/prompting.md
Prompts de exemplo: references/sample-prompts.md
Solução de problemas: references/troubleshooting.md
Dicas de rede/sandbox: references/codex-network.md

Mapa de referência

references/cli.md: como executar create/poll/remix/download/batch via scripts/sora.py.
references/video-api.md: controles em 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 (exemplos apenas; sem teoria extra).
references/cinematic-shots.md: templates para shots fílmicos.
references/social-ads.md: templates para beats curtos de anúncios sociais.
references/troubleshooting.md: erros comuns e correções.
references/codex-network.md: solução de problemas de rede/aprovação.

sora

SKILL.mdskills/skills/video/sora/SKILL.md