HD70X/nxtpath-minimax-video

Nxtpath MiniMax Vídeo

Use o cliente independente scripts/nxtpath_minimax_video.py, gateway fixo https://api.nxtpath.ai/v1, modelo padrão minimax/minimax-h3. Os parâmetros seguem o canal H3 da Nxtpath, não se aplicam à interface direta oficial da MiniMax ou aos parâmetros do Seedance. As interfaces verificadas e o escopo de validação estão em Base da Interface.

Configuração e Entrada

• Reutilize a NXTPATH_API_KEY da máquina local; a variável de ambiente tem prioridade; caso contrário, leia de ~/.config/nxtpath/env; NXTPATH_ENV_FILE pode sobrescrever o caminho do arquivo. Não leia credenciais de chat do Claude, Codex ou Grok; não coloque a chave na linha de comando ou no registro de tarefas.
• Localize o cliente a partir do diretório real deste skill. Priorize ~/.config/nxtpath/venv/bin/python; para entrada de texto ou imagem HTTPS, apenas Python 3.9+ é necessário. Para hospedagem de imagens locais, também é necessário o boto3 em scripts/requirements.txt; consulte Configuração e Recuperação.
• Leia primeiro o material do projeto de destino e as convenções de privacidade. Cada candidatura usa um novo diretório de tarefa, por padrão colocado no diretório ignorado tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/ do projeto; sem projeto, use um diretório temporário no espaço de trabalho atual ou local especificado pelo usuário. Não sobrescreva tarefas antigas nem substitua automaticamente recursos oficiais.
• Exemplo padrão: 4 segundos, 720p, 16:9. Duração em segundos inteiros de 4 a 12, resoluções apenas 720p / 960p / 2k, proporções 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16.
• Três modos de entrada: apenas texto; --first-frame e/ou --last-frame (no máximo uma imagem cada); --ref-image (imagem de referência comum, repetível). Quadros inicial/final e imagens de referência comuns não podem ser misturados; não há suporte para áudio ou vídeo de referência. Imagens de referência comuns não têm o papel de quadro inicial/final.
• Imagens via URL HTTPS, ou localmente PNG/JPEG/WebP (máximo 20 MiB cada). Rejeite data URLs. Imagens muito grandes devem ser redimensionadas para cópias menores, sem modificar o original do usuário.

Criação e Consulta

Gere uma candidatura quando o usuário solicitar explicitamente a geração de vídeo; lote e retrabalho seguem a convenção atual. Apenas verificar configurações, pesquisar interfaces ou criar o skill não autoriza geração paga. Sem tentativas extras acordadas, não regenere automaticamente tarefas com falha nem troque de modelo.

1. Use doctor --check-api para verificar somente leitura: credenciais, model_available e model_supported; se alguma verificação de modelo retornar false, pare o envio e verifique o diretório ou configuração.
2. Conforme solicitação do usuário, organize ação, enquadramento, duração e personagens/objetos a manter; escreva o prompt em arquivo UTF-8. Use prepare para congelar prompt, parâmetros e snapshots de entrada; este comando é executado offline, não gera vídeo.
3. Se houver imagens locais, execute host, usando R2 privado configurado, reutilizando hash de conteúdo, assinando GET por 24 horas e verificando hash de download. Esta operação envia entrada para R2 e para o provedor de vídeo; se falhar, pare, não troque automaticamente para hospedagem pública ou outra conta. Apenas texto ou já com imagens HTTPS pode pular esta etapa.
4. Execute submit uma vez. Ele persiste o registro exclusivo de submissão e a chave de idempotência antes do POST pago; em seguida, consulte com status independente. Status do serviço: Pending / Running / Success / Failure / Expired. Aguarde com interrupção permitida pelo host e mantenha comunicação de progresso; não faça loops de minutos em chamadas shell longas.
5. Em Success, use download para baixar e verificar o MP4. Se falhar, apenas retente o download; Failure / Expired são estados finais da tarefa — reporte o resultado, não crie automaticamente nova tarefa paga.
6. Para retomar em nova conversa, use o caminho original do job; primeiro inspect, depois status / download. Se houver registro de submissão, timeout, desconexão ou falta de task ID, não refaça POST; se resultado incerto, consulte o provedor conforme registro privado, não use nova tentativa para contornar.

Exemplo de comandos (PY, CLIENT, JOB, PROMPT_FILE e variáveis de imagem indicam caminhos reais; JOB não deve existir ainda):

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --last-frame "$LAST_FRAME" --duration 4 --resolution 720p --ratio 16:9
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

Quando houver apenas o quadro inicial, omita --last-frame; para imagem de referência comum, use --ref-image no lugar dos dois parâmetros de quadro; para vídeo a partir de texto, omita todos os parâmetros de imagem e host. A variável local NXTPATH_MINIMAX_MODEL ou --model explícito só pode selecionar IDs H3 já suportados; não faça fallback automático para outros canais.

Entrega

Entregue o video.mp4 local reproduzível e o diretório da tarefa, exibindo o vídeo com caminho absoluto. Explique os parâmetros reais e se a velocidade, ação e quadros inicial/final foram revisados; sucesso HTTP não prova qualidade visual ou consistência de personagem. O suporte a quadros inicial/final na interface não garante pixel a pixel; o resultado é baseado no vídeo real.

Prompts, URLs de imagem assinadas, handles de tarefa e respostas são salvos em registros legíveis apenas pelo usuário atual; não cole tudo no chat ou no Git. O console exibe apenas a impressão digital do handle da tarefa. O Bearer do vídeo é enviado apenas ao handle de artefato correspondente deste gateway; downloads de mídia HTTPS após redirecionamento usam requisições anônimas.