create-image-gpt-image-fal

# create-image-gpt-image-fal ## Purpose Generate one image via fal.ai's OpenAI gpt-image endpoints. Two model families are supported through a single `--model` flag: - **`gpt-image-1`** (default) — `fal-ai/gpt-image-1`. The FAL fallback for Higgsfield's `gpt_image_2`. Fixed output sizes only. Used by: - `video-orchestrator/lock-character` Phase 0 (anchor portrait) and Phase 1 (angle keyframes via `/edit`) - `video-orchestrator/create-clips` Phase 1 for photoreal scenes - the orchestrator's `generate_with_fallback.py` router on Higgsfield failure - **`gpt-image-2`** — `openai/gpt-image-2`. The newer model; accepts **custom output sizes** (any multiple of 16, up to 3840px) and renders dense text/layouts well. Used for designed sheets such as ad storyboards (`create-storyboard-sheets-fal`). The default stays `gpt-image-1` so existing callers and the lock-character anchor-parity contract are unaffected. Opt into the newer model with `--model gpt-image-2`. ## Pricing (approximate, as of 2026-05) - **gpt-image-1** — $0.04 (low), $0.08 (medium), $0.20 (high) per image. Source: [fal.ai/models/fal-ai/gpt-image-1](https://fal.ai/models/fal-ai/gpt-image-1). - **gpt-image-2** — token-priced; rough per-image estimate $0.02 (low), $0.07 (medium), $0.19 (high). Source: [fal.ai/models/openai/gpt-image-2](https://fal.ai/models/openai/gpt-image-2). The script defaults to `medium`; pass `--quality high` for finals. ## Inputs Required: - `--prompt` — text prompt. A verbatim charac...