用途:通过 Arcads 的 POST /v2/images/generate 接口,使用 Nano Banana 系列模型生成一张或多张独立的 Meta 图片广告创意,生成结果以文件路径交给用户的 Meta 广告构建技能,本技能不负责上传 Meta。
主要能力:支持 image(默认,新图)与 image_edit(修改 --source 图像)两种模式;宽高比仅支持 1:1、16:9、9:16;最多 14 张参考图;模型可选 nano-banana-2(默认)、nano-banana-pro(更高成本、锁定身份)、nano-banana-edit(局部重绘)与旧版 nano-banana,拒绝其他模型。默认强制启用去平台截图装饰(NO_CHROME_SUFFIX)与边缘/字形安全后缀,除非显式使用 --allow-chrome 或 --no-safe-zone。调用前必须给出积分成本估算并等待确认,nano-banana-pro 成本高于 nano-banana-2。
使用方式:需在 .env 中配置 ARCADS_BASIC_AUTH(优先)或 ARCADS_API_KEY,可选 PRODUCT_ID、PROJECT_ID;参考图需在本地磁盘,脚本内部处理 Arcads 预签名上传流程。核心命令示例:generate_image.py --prompt "<rewritten>" --aspect-ratio <ratio> --n <N> --image-ref <product.png> --out ./generated --env-file .env;高要求主图可加 --model nano-banana-pro;编辑运行使用 --mode image_edit --model nano-banana-edit --source <existing.png>。每行 stdout 输出一个 JSON 变体,记录 variant、path、asset_id、width、height、prompt、mode、aspect_ratio、model。生成后需进行视觉质检,检查小字乱码、多指/肢体数量错误、品牌字标漂移与角色身份漂移,每变体最多重试 2 次。
适用场景与限制:适用于生成独立 Meta 图片广告素材并交接给广告构建技能;不包含 Meta 上传、gpt-image-2 生成、视频/轮播/DCO 广告与广告文案写作。401/403 需修正 .env;422 需收紧提示词并检查宽高比与 --n≤5;500 UNKNOWN_ERROR 多因预签名 filePath 过期。共享模板库中 2:3、4:5、3:2 等比例在此后端不支持,可改用 1:1 后裁切,或使用支持完整 Meta 比例集的 KIE 同系列技能。