HD70X/nxtpath-video

哪都通 Vídeo a partir de Imagem (Antigravity)

Use o cliente Python independente deste Skill para gerar vídeos candidatos. O modelo padrão é o seedance-2.5, já testado; o fluxo de criação não depende de projetos específicos, outras árvores de trabalho ou estado de implantação.

Configuração Local e Ponto de Entrada

• A credencial unificada é NXTPATH_API_KEY, lida por padrão da variável de ambiente ou de ~/.config/nxtpath/env. A variável de ambiente tem prioridade; NXTPATH_ENV_FILE pode especificar uma configuração privada alternativa. Não leia tokens de chat de outros aplicativos, não coloque a chave em comandos, Skills, relatórios ou registros de tarefas.
• Novos processos zsh carregam a configuração local via ~/.zshenv; para GUI ou processos antigos sem herança de ambiente, o cliente ainda pode ler diretamente os arquivos acima. Apenas reporte se a configuração existe, não exiba seu conteúdo.
• Localize scripts/nxtpath_video.py a partir do diretório do Skill atualmente carregado. Use preferencialmente ~/.config/nxtpath/venv/bin/python; se não existir, as APIs de imagem de referência HTTPS e vídeo podem ser executadas diretamente com Python 3.9+. A hospedagem de imagens locais também requer o boto3 de scripts/requirements.txt.
• No projeto de destino, primeiro leia os recursos aplicáveis e as convenções de privacidade. Por padrão, as tarefas são colocadas em tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/, que é ignorado pelo projeto; quando não há projeto, use o diretório de saída selecionado pelo usuário. Não sobrescreva tentativas antigas, não adicione candidatos automaticamente à construção ou a recursos oficiais.

Realizar uma Criação ou Retomar uma Tarefa Existente

Quando o usuário solicitar explicitamente a geração de um vídeo específico, conclua um candidato conforme a solicitação, sem repetir confirmações genéricas. Apenas perguntar sobre roteiro, configuração ou uso do Skill não autoriza geração paga. O número de lotes, o número de retrabalhos e a faixa de custo seguem o acordo do usuário para esta sessão; se não acordado, faça um primeiro, não expanda automaticamente ou regenere tarefas com falha.

1. Execute doctor --check-api via run_command para verificar credenciais e modelos disponíveis. Esta é uma requisição somente leitura, não gera vídeos.
2. Confirme a imagem de referência e a descrição da ação (para imagens de referência locais, use primeiro read_file para visualizar). Esclareça o estágio da ação, enquadramento, composição, duração, personagens e adereços que precisam ser mantidos; para amostras não especificadas, o padrão é 4 segundos / 480p, não trate amostras de baixa resolução padrão como resultado final. A taxa de quadros nativa, consistência do personagem, pose inicial/final e transparência são baseadas no vídeo real.
3. Salve o prompt como um arquivo UTF-8 e use prepare para estabelecer a entrada imutável. --reference pode ser passado várias vezes para imagens locais PNG/JPEG/WebP ou URLs HTTPS; estas são imagens de guia comuns, não podem afirmar que a API travou quadros-chave inicial/final. Vídeo a partir de texto pode ser feito sem imagem de referência.
4. Quando houver imagens locais, execute host para fazer upload ou reutilizar um snapshot de entrada em um bucket R2 privado configurado, emitir um GET de 24 horas e verificar o hash de download. Esta operação passa a imagem de referência para o serviço de hospedagem e o provedor de vídeo; deve estar dentro do escopo dos素材 solicitados pelo usuário. Se a hospedagem falhar, não submeta o vídeo, não troque automaticamente de conta, bucket público ou serviço. Para imagens de referência já HTTPS, host não é necessário.
5. Execute submit apenas uma vez. Ele primeiro persiste um registro de submissão exclusivo e, em seguida, emite um POST pago. Depois, consulte com status independente; após o sucesso, use download para obter video.mp4; cada comando é executado independentemente via run_command, não coloque polling de minutos em uma única chamada shell longa e nunca use sleep do shell como temporizador. Quando precisar esperar, use schedule(DurationSeconds=...) para definir um temporizador único e terminar a rodada atual aguardando ativação, então execute status novamente. Não regenere a requisição devido a timeout.
6. Ao retomar entre conversas, use o caminho do job original, primeiro inspect, depois status / download. Não repita POST para tentativas já submetidas, com resultados desconhecidos ou sem ID de tarefa; quando não houver ID de tarefa, consulte o provedor com base em registros de submissão privados. Se o download falhar, apenas tente o download novamente. Em caso de 401/403, cota insuficiente ou modelo indisponível, pare a submissão, relate o motivo, não troque automaticamente de chave, modelo ou interface.

Exemplo de comandos (CLIENT refere-se ao script no Skill atual; PY refere-se ao Python local; JOB é o diretório da tarefa recém-criada):

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --reference "$REFERENCE_IMAGE" --duration 4 --resolution 480p --ratio 1:1
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

Entrega e Limites

Entregue como um vídeo local reproduzível e o caminho do job, use um link [video.mp4](file:///absolute/path/to/video.mp4) para exibir o vídeo e explique que é um candidato e o que foi realmente verificado. Quando precisar revisar o resultado final, use a ferramenta read_file do Antigravity para ler o video.mp4 baixado (suporte nativo a leitura multimodal de vídeo), verifique a velocidade original, ações-chave e pose inicial/final; não considere sucesso HTTP como aprovação de ação ou arte.

Os registros da tarefa contêm o prompt, snapshot de entrada, requisição exata, handle da tarefa do provedor, resultado e hash do arquivo; as permissões padrão são legíveis apenas pelo usuário atual; estes registros podem conter URLs de assinatura temporária, não cole tudo no chat ou no Git. O console mostra apenas o fingerprint do handle da tarefa. Remoção de fundo, transparência, transições SVG e integração com aplicativos são trabalhos posteriores, tratados de acordo com as ferramentas e autorizações do projeto de destino.

Leia Configuração e Recuperação de Falhas apenas ao trocar de dispositivo, atualizar credenciais ou se a hospedagem falhar. A referência da interface está em Skill Seedance do Provedor.