用途:通过 fal.ai 的 OpenAI gpt-image 端点生成单张图片,用单个 --model 参数切换两个模型系列。gpt-image-1(默认,fal-ai/gpt-image-1)仅支持固定尺寸,用于角色锚点与角度关键帧、写实场景,以及 Higgsfield 失败时的回退路由。gpt-image-2(openai/gpt-image-2)支持自定义尺寸(16 的倍数,上限 3840px),适合广告分镜表等密集文字与版式。默认保持 gpt-image-1 以不影响既有调用方,用 --model gpt-image-2 选用新模型。
主要能力:文生图与基于参考图的 /edit 变体。必填 --prompt 与 --output;可选 --model、--aspect-ratio(默认 9:16,另有 16:9、1:1、2:3、3:2,gpt-image-2 还支持 3:4、4:3、4:5)、--image-size(仅 gpt-image-2,如 1728x2304)、--quality(low/medium/high,默认 medium)、--ref-image/--ref-url(可重复,须为公开 URL,顺序为先身份后风格)、--with-logs。
使用方式:凭据经 GooseWorks fal-proxy 路由,读取 ~/.gooseworks/credentials.json(由 gooseworks login 写入),不要设置 FAL_API_KEY。设置 GW_PROJECT_ID 以归属花费。预检:test -f ~/.gooseworks/credentials.json || { echo "Missing credentials — run: gooseworks login"; exit 1; } 与 python3 -c "import requests" || pip3 install requests。运行示例:python3 skills/ads/capabilities/create-image-gpt-image-fal/scripts/generate.py --prompt "..." --output /path/to/anchor.png --aspect-ratio 9:16 --quality medium。脚本经代理提交并轮询队列,下载首张结果图,并写出 <output>.meta.json(含 gateway、模型 id、model_family、请求与费用)。
适用场景:角色锚点与角度生成、写实场景、设计类分镜表。限制:参考图必须为公开 URL,代理不上传本地文件;gpt-image-1 忽略自定义尺寸并回退到宽高比映射;gpt-image-2 尺寸需为 16 倍数且不超过 3840px;429 时降低并发至 2-3;图像模型易错渲染可读文字(如品牌名、URL、代码),文字叠加建议用 PIL 或 ffmpeg drawtext;角色锚点须固定同一 --model 以避免风格漂移。价格与更多细节以官方资料为准。