HD70X/nxtpath-minimax-video

哪都通 MiniMax 视频

Utiliza el cliente independiente scripts/nxtpath_minimax_video.py, con la puerta de enlace fija https://api.nxtpath.ai/v1 y el modelo predeterminado minimax/minimax-h3. Los parámetros se basan en el canal H3 de Ndtong, sin aplicar la interfaz directa oficial de MiniMax ni los parámetros de Seedance. La interfaz verificada y el alcance de validación se detallan en Base de interfaz.

Configuración y entrada

• Reutiliza la NXTPATH_API_KEY local, dando prioridad a las variables de entorno; de lo contrario, analiza ~/.config/nxtpath/env; NXTPATH_ENV_FILE puede sobrescribir la ruta del archivo. No lee credenciales de chat de Claude, Codex o Grok, y no coloca la clave en la línea de comandos ni en los registros de tareas.
• Localiza el cliente desde el directorio real de esta skill. Prioriza el uso de ~/.config/nxtpath/venv/bin/python; la entrada de texto o imágenes HTTPS solo requiere Python 3.9+. El alojamiento de imágenes locales también necesita boto3 de scripts/requirements.txt; las instrucciones de configuración están en Configuración y recuperación.
• Primero lee los materiales del proyecto y las convenciones de privacidad. Cada candidato utiliza un nuevo directorio de tareas, por defecto colocado en tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/ (ignorado por el proyecto); si no hay proyecto, se usa un directorio temporal en el área de trabajo actual o una ubicación especificada por el usuario. No sobrescribe tareas antiguas ni reemplaza automáticamente recursos oficiales.
• La muestra predeterminada es de 4 segundos, 720p, 16:9. La duración es un entero de 4 a 12 segundos, las resoluciones solo 720p / 960p / 2k, y las relaciones de aspecto 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16.
• Tres modos de entrada: solo texto; --first-frame y/o --last-frame (cada uno hasta una imagen); --ref-image repetible para imágenes de referencia normales. Los fotogramas inicial/final y las imágenes de referencia normales no pueden mezclarse; no se admiten audio de referencia ni video de referencia. Las imágenes de referencia normales no tienen el rol de fotogramas inicial/final.
• Las imágenes usan URL HTTPS, o PNG/JPEG/WebP locales (cada una hasta 20 MiB). Se rechazan los data URL. Las imágenes demasiado grandes deben redimensionarse primero a una copia más pequeña, sin modificar la imagen original del usuario.

Creación y seguimiento

Cuando el usuario solicite explícitamente la generación de un video, completa un candidato; el número de lotes y repeticiones sigue el acuerdo actual. Solo verificar configuración, investigar la interfaz o crear la skill no autoriza la generación de pago. Sin acuerdo de intentos adicionales, no regenerar automáticamente tareas fallidas ni cambiar de modelo.

1. Usa doctor --check-api para verificar solo lectura de credenciales, model_available y model_supported; si alguna verificación de modelo es falsa, detén el envío y verifica el directorio o la configuración.
2. Organiza acciones, tomas, duración y los roles/objetos que deben mantenerse según la solicitud del usuario, y escribe el prompt en un archivo UTF-8. Usa prepare para congelar el prompt, los parámetros y una instantánea de la entrada; este comando se ejecuta sin conexión y no genera video.
3. Si hay imágenes locales, ejecuta host, usando el R2 privado configurado, reutilizando objetos hash de contenido, emitiendo GET de 24 horas y verificando el hash de descarga. Esta operación envía la entrada a R2 y al proveedor de video; si el alojamiento falla, detente, sin cambiar automáticamente a un servicio de imágenes público o cuenta diferente. Solo texto o imágenes HTTPS existentes pueden omitir este paso.
4. Ejecuta submit una vez. Antes del POST de pago, persiste un registro de envío exclusivo y una clave de idempotencia; luego consulta con status independiente. El estado del servicio es Pending / Running / Success / Failure / Expired. La espera puede ser interrumpida por el anfitrión, manteniendo la comunicación del progreso, sin bucles de larga duración en llamadas de shell.
5. En Success, usa download para descargar y verificar el MP4. Si la descarga falla, solo reintenta la descarga; Failure / Expired son estados finales de la tarea; reporta el resultado, sin crear automáticamente una nueva tarea de pago por esto.
6. Para recuperar entre diálogos, usa la ruta original del trabajo, primero inspect, luego status / download. Si existe un registro de envío, tiempo de espera, desconexión o falta de ID de tarea, no se debe rehacer el POST; si el resultado es incierto, verifica con el proveedor según los registros privados, sin usar un nuevo intento para evitarlo.

Ejemplos de comandos (PY, CLIENT, JOB, PROMPT_FILE y las variables de imagen se refieren a rutas reales; JOB no debe existir):

"$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"

Si solo hay fotograma inicial, omite --last-frame; para imágenes de referencia normales, usa --ref-image en lugar de los dos parámetros de fotograma; para generación de texto a video, omite todos los parámetros de imagen y host. La variable local NXTPATH_MINIMAX_MODEL o el --model explícito solo pueden seleccionar IDs H3 compatibles, sin retroceder automáticamente a otros canales.

Entrega

Entrega el video.mp4 local reproducible y el directorio de la tarea, mostrando el video con rutas absolutas. Explica los parámetros reales y si se revisaron la velocidad original, las acciones y los fotogramas inicial/final; el éxito HTTP no garantiza la calidad visual o la consistencia de los personajes. La interfaz admite fotogramas inicial/final, pero no garantiza píxel por píxel; el resultado se basa en el video real.

El prompt, las URL de imágenes firmadas, el identificador de la tarea y la respuesta se guardan en registros legibles solo por el usuario actual; no los pegues enteros en el chat ni los envíes a Git. La consola solo muestra la huella del identificador de la tarea. El Bearer del video solo se envía al identificador de artefacto correspondiente en esta puerta de enlace; las descargas de medios HTTPS después de la redirección utilizan solicitudes anónimas.