xiongxianzhu Agnes 生图（agnes-image）
调用 Agnes Image 2.1 Flash 完成文生图与图生图。优先执行 scripts/generate.py，避免手写易错的请求体。完整接口细节见 references/api.md。
前置
- 环境变量
AGNES_API_KEY（请求头Authorization: Bearer <key>）；切勿把真实 key 写进代码或文档，公开示例一律用YOUR_API_KEY。 - 生图耗时数秒到数十秒，客户端超时建议 60s–360s。
工作流程
- 从请求与上下文提取 prompt、尺寸、输出路径及图生图的输入图和「保留/改变」要求。已有有效参数直接采用；普通缺省项使用脚本默认值或工作区内不覆盖已有文件的路径。仅在必要输入缺失或选择会实质影响结果、费用时询问；已有生成授权不重复确认，不据此扩大调用数量或费用范围。
- 按 推荐 prompt 结构 组织描述。
- 调脚本生成（默认文生图、URL 输出后自动下载到本地）：
# 文生图
python scripts/generate.py \
--prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism, wide-angle, high visual density" \
--size 1024x768 \
--out out/city.png
# 图生图（输入可为公网 URL 或本地文件，本地文件自动转 Data URI）
python scripts/generate.py \
--prompt "Transform into a rain-soaked cyberpunk night with neon reflections, preserve the original composition" \
--size 1024x768 \
--image https://example.com/input.png \
--out out/cyberpunk.png
- 失败时按 references/api.md 的「常见错误」排查（最常见：
response_format放错层级、img2img 缺image、输入图不可公网访问）。
关键约束（务必遵守）
- 模型名固定
agnes-image-2.1-flash。 response_format（url/b64_json）必须放在extra_body内，不可放顶层。- 文生图要 Base64：用顶层
return_base64: true。 - 图生图：在
image数组传输入图；不要传tags: ["img2img"]。 - 文生图必填
model、prompt、size。
prompt 结构
[主体] + [场景/环境] + [风格] + [光照] + [构图] + [质量要求]
图生图改用：[改变要求] + [新风格/场景] + [增删元素] + [需保留的元素]，明确「改什么、保留什么」。
脚本
scripts/generate.py：封装请求体与输出处理。零第三方依赖（标准库）。
python scripts/generate.py --prompt "..." --size 1024x768 --out out/x.png # 文生图→下载
python scripts/generate.py --prompt "..." --image in.png --out out/y.png # 图生图
python scripts/generate.py --prompt "..." --out out/z.png --raw-base64 # 强制 Base64 输出
- 读取
AGNES_API_KEY；--out为.png等本地路径。 - URL 输出会自动下载保存；Base64 输出会解码保存。