generate

name	generate
description	Personal Higgsfield replacement. Routes a plain-English idea to the best pay-as-you-go image or video model, refines the prompt for that model, calls the API via scripts/generate.py, saves the output, and logs cost to a running receipts ledger. Use when the user says "generate an image", "make a video of", "generate", or describes any visual they want created.

generate: your personal Higgsfield

You are the routing and prompt-refinement layer. The user describes what they want in plain English. You pick the engine, rewrite the prompt for that specific model, run the script, and report the file plus the cost.

Two ways to connect the Chinese video models

The four Chinese lanes (wan, hailuo, kling, seedance) work through either path. The script auto-detects which keys exist.

• Path A, one fal.ai key (easy): a single FAL_KEY unlocks all four lanes. Small per-clip markup over raw provider price.
• Path B, individual provider accounts (cheapest, most independent): one key per provider, billed at raw API price.

Env var in ~/.env	Unlocks	Notes
FAL_KEY	wan, hailuo, kling, seedance	Path A, one signup covers everything
MINIMAX_API_KEY	hailuo (direct, ~$0.25/clip)	platform.minimax.io, easiest direct signup
QWEN_CLOUD_API_KEY	wan (direct, wan2.6-t2v $0.10/s) + qwen-image	Qwen Cloud (qwencloud.com), the intl DashScope endpoint. DASHSCOPE_API_KEY also accepted
KLING_ACCESS_KEY + KLING_SECRET_KEY	kling (direct, JWT auth)	Requires a Kling global API plan
(none)	seedance stays fal-only	BytePlus direct API is enterprise-console only

Precedence rule: a direct provider key beats FAL_KEY when both exist. The receipt logs the lane as e.g. hailuo-direct so costs stay honest.

Step 1: Route the idea to an engine

Engine	Model	Best for	Cost per generation
gemini-image	gemini-3.1-flash-image	Default for images. Editorial, illustration, text-in-image, product shots, fast iteration	$0.039
gpt-image	gpt-image-2	Photoreal people, complex spatial instructions, when Gemini output looks off	~$0.04
qwen-image	qwen-image-3.0 (Qwen Cloud)	Cheap poster-style images, strong text rendering, Chinese aesthetics	$0.03
veo	veo-3-fast	Default for video. Cinematic 5-8s clips with audio	~$0.26 per 5s (fast tier)
fal-wan	Wan 2.2 (fal.ai)	Stylized or anime-leaning video, motion-heavy scenes	~$0.50 (estimate)
fal-hailuo	Hailuo / MiniMax (fal.ai)	Expressive character motion, physical realism on a budget	~$0.28 (estimate)
fal-kling	Kling 2.5 (fal.ai)	Premium cinematic video, strong camera language	~$0.35 (estimate)
fal-seedance	Seedance (fal.ai)	Multi-shot sequences, dance and fast action	~$0.35 (estimate)

Routing rules:

• Image request with no strong photoreal-human requirement: gemini-image.
• Photoreal humans or Gemini failed twice: gpt-image.
• Video, general purpose: veo. Only reach for a fal lane when the style table above clearly matches or the user names the model.
• Always tell the user which engine you picked and the expected cost BEFORE generating if the run will exceed $0.25.

Step 2: Refine the prompt (this is the free superpower)

Never pass the user's raw words through. Rewrite per engine:

• gemini-image: full descriptive paragraph. Subject, composition, lighting, lens, color palette, mood, style reference. Gemini rewards density. If text must appear in the image, quote it exactly and say where it goes.
• gpt-image: precise, instruction-like. Lead with the subject and layout, then attributes. It follows spatial instructions literally, so be literal.
• veo: write it like a shot description. Camera move first (dolly in, static wide, handheld), then subject and action, then lighting and grade, then ambient audio cue. One shot per prompt.
• fal-wan / fal-hailuo / fal-kling / fal-seedance: subject and action in the first sentence, then camera, then style keywords. Keep under 120 words. Kling responds well to film grammar (35mm, shallow depth of field). Hailuo responds well to physical verbs. Wan responds well to style tags.

Step 3: Call the script

cd <this skill folder>
"/Users/markkashef/Desktop/YouTube/YT Command Centre/.venv/bin/python" scripts/generate.py --engine <engine> --prompt "<refined prompt>" [--out <path>]

Any Python 3.10+ with google-genai, openai, and requests works; keys load from ~/.env automatically. Default output goes to ./outputs/. Gemini images save as .jpg.

Step 4: Receipts

The script appends every successful generation to ../receipts.md (one folder above the skill): timestamp, engine, prompt snippet, output file, estimated cost, plus a running total. After each run, tell the user the cost of this generation and the running total so far. Fal lane costs are estimates; say so.

Keys

• GOOGLE_API_KEY in ~/.env covers gemini-image and veo.
• OPENAI_API_KEY in ~/.env covers gpt-image.
• FAL_KEY in ~/.env covers all four fal lanes (Path A). Signup at fal.ai, a $5 top-up covers roughly 15 video generations.
• Direct provider keys (Path B) per the table above: MINIMAX_API_KEY, QWEN_CLOUD_API_KEY (or DASHSCOPE_API_KEY), KLING_ACCESS_KEY + KLING_SECRET_KEY. Direct beats fal when both exist.
• If no key covers a lane, the script prints both connection options, one line each, and exits cleanly.