# 1-h Image Providers (`1h-openai-image` & `1h-gemini-image`) OpenClaw 图像生成驱动模块集合,根据上游协议严格分离为两个专职驱动,彻底杜绝跨协议调用引发的 400 错配。 --- ## 包含驱动一览 | Provider ID | 对应协议 | 默认模型 | 适用场景 / 支持模型 | | :--- | :--- | :--- | :--- | | **`1h-openai-image`** | OpenAI 标准图像协议
(`POST /v1/images/generations`) | `gpt-image-2` | 专为号池/公益站的 OpenAI 协议图像生成打造:
• `gpt-image-2`
• `gpt-image-2.5`
• `gpt-image-2.5-flare`
• `gpt-image-2.5-sunburst` | | **`1h-gemini-image`** | Google Gemini 原生内容协议
(`POST /v1beta/models/...:generateContent`) | `gemini-3.1-flash-image` | 专为渠道 87(CLI-Proxy)的原生 Gemini 图像生成打造:
• `gemini-3.1-flash-image` | --- ## 核心特性 1. **`1h-openai-image`(OpenAI 协议)**: * **尺寸安全映射**:自动将 16:9 / 9:16 安全归一化为通用尺寸(`1792x1024` / `1024x1792` / `1536x1024`),修复 Issue #168665; * **URL 优先与双模自适应**:默认使用 `response_format=url`,完美契合公益站防 400 校验,并自动将链接异步下载为本地图片文件; * **图生图编辑**:传入 `inputImages` 时自动切至 Multipart 表单走 `/v1/images/edits`。 2. **`1h-gemini-image`(Gemini 协议)**: * **原生 JSON 结构**:以标准的 `contents[].parts` 构造请求,并在返回时原生提取 `inlineData` Base64 流; * **无损回退链**:作为主模型的首选备用渠道,当 OpenAI 渠道拥堵超时时,以纯正 Gemini 协议秒级接管。 --- ## 配置说明 在 `~/.openclaw/openclaw.json` 中配置: ```json5 { "plugins": { "entries": { "1h-tools": { "enabled": true, "config": { "openaiImage": { "baseUrl": "http://host.incus.internal:8080/v1", "defaultModel": "gpt-image-2", "apiKey": "1842894d437ee54443a99390f79811ba9ebb785175af340b492e3398dc317921", "responseFormat": "url", "allowPrivateNetwork": true }, "geminiImage": { "baseUrl": "http://host.incus.internal:8080/v1beta", "defaultModel": "gemini-3.1-flash-image", "apiKey": "1842894d437ee54443a99390f79811ba9ebb785175af340b492e3398dc317921", "allowPrivateNetwork": true } } } } }, "agents": { "defaults": { "mediaModels": { "image": { "primary": "1h-openai-image/gpt-image-2", "fallbacks": [ "1h-gemini-image/gemini-3.1-flash-image" ] } } } } } ``` --- ## 使用方法 配置完成后,OpenClaw 内置的 `image_generate` 工具即可自动调度: * **正常请求**:默认走 `1h-openai-image/gpt-image-2`; * **容灾回退**:若主模型超时(如公益站排队超时 499),系统自动使用纯正的 `1h-gemini-image/gemini-3.1-flash-image` 协议回退,绝不报 400。