runway-mv-queue

Local shot planner + Runway API submitter for AI-generated music videos.

This version is shaped around the current API reality:

• API billing is separate from the web app
• low-tier accounts may have concurrency = 1
• daily generation count is often more important than raw queue depth

What it does

• Loads a shot manifest
• Estimates credit cost before submission
• Filters by status and priority
• Caps daily submissions and credit spend
• Uploads local input stills to Runway
• Submits image-to-video generations
• Downloads completed outputs
• Logs everything to JSONL

Install

npm install
cp .env.example .env
# add your Runway API key

Quick start

Preview your plan:

npm run plan

Submit only ready shots, with a max of 5 generations and 300 credits:

npm run submit -- --only ready --max-daily-submits 5 --max-credit-spend 300

Run in dry-run mode:

npm run submit -- --only ready --dry-run

Manifest fields

Each shot can include:

• id: unique identifier
• section: intro / verse / chorus / etc
• status: idea, ready, submitted, keep, rerun, junk
• priority: lower number means earlier submission
• promptText: prompt for Runway
• input: optional local image path
• duration: seconds
• ratio: output resolution string like 1280:768
• seed: optional seed
• model: defaults to gen4.5
• notes: freeform notes

Notes

• Default credit estimator assumes Gen-4.5 at 12 credits / second.
• This is just a local planning heuristic. Check current Runway pricing before large runs.
• The CLI favors deliberate selection over blindly filling slots.