fk-review-video

Review AI-generated scene videos for quality using Claude Vision.

Usage: /fk-review-video <video_id> [--mode light|deep]

Default mode: light. Orientation auto-detected from project meta.json.

Prerequisites

• ANTHROPIC_API_KEY env var set
• ffmpeg + ffprobe installed
• Scenes must have completed videos (${ori}_video_status = COMPLETED)

Step 1: Pre-check

# Verify server + extension connected
curl -s http://127.0.0.1:8100/health
# Must return: {"extension_connected": true}

# Verify video exists
curl -s http://127.0.0.1:8100/api/videos/<VID>

ABORT if extension not connected or video not found.

Step 2: Check scenes have completed videos

curl -s "http://127.0.0.1:8100/api/scenes?video_id=<VID>"

For each scene, verify ${ori}_video_status = COMPLETED (orientation auto-detected from meta.json).

ABORT if any scene is missing a completed video — tell user to run /fk-gen-videos first.

Step 3: Run review via API

curl -X POST "http://127.0.0.1:8100/api/videos/<VID>/review?project_id=<PID>&mode=light&orientation=${ORI}"

Parameters:

• mode: light (default) or deep
• orientation: auto-detected from meta.json (${ORI})

The API will extract frames from each scene video, send them to Claude Vision, and return per-scene quality scores.

Poll until complete:

curl -s http://127.0.0.1:8100/api/requests/<RID>
# Wait for status: "COMPLETED"

Step 4: Interpret results

The response is an array of per-scene review objects:

[
  {
    "scene_id": "abc-123",
    "display_order": 0,
    "total_score": 8.5,
    "dimensions": {
      "character_consistency": 9.0,
      "prompt_adherence": 8.5,
      "motion_quality": 8.0,
      "visual_fidelity": 8.5,
      "temporal_coherence": 8.0,
      "composition": 9.0
    },
    "errors": ["Slight motion blur at 4s mark"],
    "fix_guide": "Acceptable as-is. If re-generating, add 'sharp focus, crisp motion' to prompt.",
    "usable": true,
    "verdict": "good",
    "usable_segments": [
      {"start": "0s", "end": "4s", "score": 9.0},
      {"start": "5s", "end": "8s", "score": 8.5}
    ]
  }
]