Generate MiniMax H3 videos with FreeVideo

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/FlashML-org/FreeVideo.git
cd FreeVideo
git checkout 0af617eb54dec1d8c06f9e7de2147c5b6a3f4772

cd /workspace/FreeVideo
./freevideo --help
./freevideo status
./freevideo doctor
./freevideo doctor --probe

mkdir -p prompts outputs
cat > prompts/coffee.txt <<'PROMPT'
Cinematic coffee cup on a wooden table beside a rainy window at dawn.
Steam rises slowly while the camera pushes in. Realistic reflections,
soft interior light. Audio: gentle rain, distant birds, cup on wood.
No text or subtitles.
PROMPT

./freevideo generate \
  --prompt-file prompts/coffee.txt \
  --width 960 --height 544 \
  --seconds 3 \
  --seed 12345 \
  --out outputs/coffee.mp4

./freevideo generate \
  --prompt-file prompts/coffee.txt \
  --width 960 --height 544 \
  --seconds 3 \
  --seed 12345 \
  --preview \
  --out outputs/coffee-preview.mp4

ffprobe -v error -show_entries format=duration -show_streams outputs/coffee.mp4

cd /workspace/FreeVideo
(
  FREEVIDEO_TOKEN="$(cat launcher/access-token)" || exit 1
  test -n "$FREEVIDEO_TOKEN" || { printf "Missing FreeVideo token\n" >&2; exit 1; }
  curl --fail-with-body --silent --show-error --max-time 30 \
    -H "Authorization: Bearer $FREEVIDEO_TOKEN" \
    http://127.0.0.1:8188/system_stats
)

#!/usr/bin/env python3
import json
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
from pathlib import Path

# Save and run this script in /workspace/FreeVideo on the Pod.
API = "http://127.0.0.1:8188"
TOKEN = Path("launcher/access-token").read_text(encoding="utf-8").strip()
if not TOKEN:
    raise SystemExit("Missing access token. Start the protected FreeVideo server first.")
HEADERS = {"Authorization": f"Bearer {TOKEN}"}
STATE = Path("freevideo-job.json")

def request_json(route, payload=None):
    headers = dict(HEADERS)
    data = None
    if payload is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(payload).encode("utf-8")
    req = urllib.request.Request(API + route, data=data, headers=headers)
    with urllib.request.urlopen(req, timeout=30) as response:
        return json.load(response)

def run():
    if sys.argv[1:] == ["--resume"]:
        prompt_id = json.loads(STATE.read_text(encoding="utf-8"))["prompt_id"]
    elif sys.argv[1:]:
        raise SystemExit("Usage: python3 queue_freevideo.py [--resume]")
    else:
        if STATE.exists():
            raise SystemExit("Saved job found: use --resume, or rename freevideo-job.json before a new job.")
        graph = json.loads(Path("workflow_api.json").read_text(encoding="utf-8"))
        payload = graph if "prompt" in graph else {"prompt": graph}
        result = request_json("/prompt", payload)
        prompt_id = result.get("prompt_id")
        if not prompt_id:
            raise SystemExit("Job was not accepted. Check graph validation in the UI; do not blindly retry.")
        STATE.write_text(json.dumps({"prompt_id": prompt_id}), encoding="utf-8")
    print("Queued job:", prompt_id, flush=True)
    route = "/history/" + urllib.parse.quote(prompt_id, safe="")
    deadline = time.monotonic() + 6 * 60 * 60
    while time.monotonic() < deadline:
        entry = request_json(route).get(prompt_id)
        if not entry:
            queue = request_json("/queue")
            jobs = queue.get("queue_running", []) + queue.get("queue_pending", [])
            if not any(len(job) > 1 and job[1] == prompt_id for job in jobs):
                entry = request_json(route).get(prompt_id)  # completion can race the queue check
                if not entry:
                    raise SystemExit("Job is absent from Queue/History. After a server restart, locate saved MP4s; do not resubmit automatically.")
        if entry:
            status = entry.get("status", {})
            if status.get("status_str") == "error":
                raise SystemExit("Generation failed. Inspect this job in ComfyUI History and its logs.")
            if status.get("completed"):
                Path("freevideo-history.json").write_text(json.dumps(entry, indent=2), encoding="utf-8")
                if status.get("status_str") != "success":
                    raise SystemExit("Job did not finish successfully; inspect its saved history.")
                break
        print("Waiting for this job; each status request is separate...", flush=True)
        time.sleep(10)
    else:
        raise SystemExit("Still waiting after 6 hours. Check the UI; --resume monitors the same job.")
    media = [item for node in entry.get("outputs", {}).values()
             for item in node.get("images", [])
             if item.get("type") == "output" and str(item.get("filename", "")).lower().endswith(".mp4")]
    if not media:
        raise SystemExit("No MP4 descriptor in saved history. Check the workspace and search the persistent output folder.")
    folder = Path("api-downloads") / prompt_id
    folder.mkdir(parents=True, exist_ok=True)
    for index, item in enumerate(media, 1):
        query = urllib.parse.urlencode({key: item[key] for key in ("filename", "subfolder", "type")})
        req = urllib.request.Request(API + "/view?" + query, headers=HEADERS)
        target = folder / (str(index) + "-" + Path(item["filename"]).name)
        partial = target.with_name(target.name + ".part")
        with urllib.request.urlopen(req, timeout=30) as response, partial.open("wb") as output:
            while chunk := response.read(1024 * 1024):
                output.write(chunk)
        partial.replace(target)
        print("Saved on the Pod:", target, flush=True)
    print("Copy the MP4s to your computer and check playback/audio before stopping the Pod.")

try:
    run()
except (urllib.error.URLError, TimeoutError) as error:
    print("Request failed:", type(error).__name__)
    raise SystemExit("No automatic resubmission. Check Queue/History; if freevideo-job.json exists, use --resume. Check the token after rotation.")

cd /workspace/FreeVideo
python3 queue_freevideo.py

cd /workspace/FreeVideo
python3 queue_freevideo.py --resume

./freevideo plan --vram-gib 16 --ram-gib 32 --width 960 --height 544 --seconds 3
./freevideo resource-history list
./freevideo predict --help

cd /workspace/FreeVideo
./freevideo status
./freevideo doctor --probe
nvidia-smi
free -h
df -h /workspace
ls -lah launcher/
tail -n 100 launcher/service.log

./freevideo status
./freevideo stop
git status --short
git fetch --tags origin

./setup.sh --plan
./setup.sh

cd /workspace/FreeVideo
./freevideo stop && ./freevideo server --listen 0.0.0.0 --port 8188
./freevideo status

nvidia-smi
df -h /workspace
apt-get update
apt-get install -y git curl ca-certificates tmux build-essential python3
cd /workspace/FreeVideo && ./setup.sh --plan

cd /workspace/FreeVideo && ./setup.sh && ./freevideo server --listen 0.0.0.0 --port 8188
./freevideo status