3.0 KiB
3.0 KiB
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 |
核心特性
-
1h-openai-image(OpenAI 协议):- 尺寸安全映射:自动将 16:9 / 9:16 安全归一化为通用尺寸(
1792x1024/1024x1792/1536x1024),修复 Issue #168665; - URL 优先与双模自适应:默认使用
response_format=url,完美契合公益站防 400 校验,并自动将链接异步下载为本地图片文件; - 图生图编辑:传入
inputImages时自动切至 Multipart 表单走/v1/images/edits。
- 尺寸安全映射:自动将 16:9 / 9:16 安全归一化为通用尺寸(
-
1h-gemini-image(Gemini 协议):- 原生 JSON 结构:以标准的
contents[].parts构造请求,并在返回时原生提取inlineDataBase64 流; - 无损回退链:作为主模型的首选备用渠道,当 OpenAI 渠道拥堵超时时,以纯正 Gemini 协议秒级接管。
- 原生 JSON 结构:以标准的
配置说明
在 ~/.openclaw/openclaw.json 中配置:
{
"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。