Sora

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

1. Decide a intenção: criar vs remixar vs status/download vs lote.
2. Colete inputs: prompt, modelo, tamanho, segundos e qualquer imagem de referência de entrada.
3. Se lote: escreva um JSONL temporário sob tmp/ (um job por linha), execute uma vez, depois delete o JSONL.
4. 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.
5. 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.
6. Para jobs assíncronos, consulte até completar (ou use create-and-poll).
7. Baixe assets (vídeo/thumbnail/spritesheet) e salve localmente.
8. 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.
9. 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:

1. Crie uma chave de API na UI da plataforma OpenAI: https://platform.openai.com/api-keys
2. Defina OPENAI_API_KEY como uma variável de ambiente no seu sistema.
3. 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.