NewAPI 图像生成

要解决什么问题

在 Agent 工作流里，你往往只有一段提示词，却需要落到可引用的本地图片文件，而不是在对话里塞 Base64 或临时 URL。NewAPI 作为聚合网关，背后可能走 OpenAI 兼容的 /v1/images/generations，也可能走 Gemini 的 generateContent；渠道、默认模型和鉴权方式都不相同，手写 HTTP 很容易在 mode、model 和响应格式之间踩坑。

技能如何工作

本技能通过 generate_image.py 统一入口，按 --mode（openai / gemini）选择接口，并在执行前优先读取 {baseDir}/.env 中的 NEWAPI_API_KEY 与 NEWAPI_BASE_URL；本地已配置且非空时直接生成，缺失再向用户补全。

• OpenAI 方式：Bearer 鉴权，默认模型 doubao-seedream-5-lite，可选 doubao-seedream-4-5；支持 --n、--quality、--style、--response-format（url / b64_json）等参数。
• Gemini 方式：通过 key= 查询参数鉴权，默认 gemini-3.1-flash-image-preview；--size 用于推导宽高比。
• 输出约定：无论返回 URL 还是 Base64，脚本都会先写入 {baseDir}/outputs（可用 --output-dir 覆盖），并以 MEDIA_FILE: 前缀输出本地路径；完成后只校验文件存在，不读入图片内容以免占满上下文。
• 口语别名：如「豆包 seedream5」「香蕉模型」会映射为真实 --model 名；脚本只接受官方模型 ID。

可用 --list-models 查看当前 model_config.py 中声明的支持矩阵。

边界与注意点

• 阿里云渠道（--mode aliyun）当前不支持，调用会直接报错。
• --size 须为 宽x高 格式，且像素总数下限为 3686400（例如默认 2048x2048）。
• 命令行 --api-key / --base-url 可覆盖 .env，但日常应以 .env 为默认来源，避免在对话里反复索要密钥。