用途:通过 9Router 的 /v1/images/generations 端点统一生成图像,可调用 OpenAI、Gemini Imagen、DALL-E、FLUX、MiniMax、SDWebUI、ComfyUI、Codex 等模型。使用前需配置 NINEROUTER_URL,若启用鉴权还需 NINEROUTER_KEY,具体设置见项目 SKILL.md。
主要能力:可用 curl $NINEROUTER_URL/v1/models/image 列出可用模型,用 /v1/models/info?id=... 查询单个模型的参数与能力(如 size、quality 枚举及是否支持编辑)。请求字段包括必填的 model、prompt,以及可选的 n、size、quality、response_format。默认返回 JSON 中的 url,也可用 b64_json;加查询参数 ?response_format=binary 可直接获得原始图像字节,便于保存文件。
使用方式:向 $NINEROUTER_URL/v1/images/generations 发送 POST 请求,携带 Authorization: Bearer $NINEROUTER_KEY 与 Content-Type: application/json。示例:curl -X POST "$NINEROUTER_URL/v1/images/generations?response_format=binary" -H "Authorization: Bearer $NINEROUTER_KEY" -H "Content-Type: application/json" -d '{"model":"gemini/gemini-3-pro-image-preview","prompt":"watercolor mountains at sunrise","size":"1024x1024"}' --output out.png。也可用 JS fetch 调用并读取 data[0].url 或 data[0].b64_json。
适用场景:需要跨多个图像模型统一调用、批量生成或保存图片时使用。
限制:不同提供方参数存在差异,例如 gemini 仅用 prompt、忽略 size/n;codex 使用 SSE 流且需 ChatGPT Plus/Pro;huggingface 仅用 prompt 且返回单图;nanobanana、fal-ai、stability-ai、black-forest-labs、runwayml 对 size 的映射或异步行为各不相同;sdwebui、comfyui 为本地 localhost 且无需鉴权(:7860 / :8188)。具体支持范围以实际模型信息为准。