# 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。