feat: split image providers into 1h-openai-image and 1h-gemini-image, rename video to 1h-openai-video
This commit is contained in:
1 parent
3c5e5dd023
commit
8cd50b1c4d
16 files changed
+1553
-102
No files matched your search
+34
-31
@@ -1,35 +1,33 @@
|
||||
# 1-h Image Provider (`1h-image`)
|
||||
# 1-h Image Providers (`1h-openai-image` & `1h-gemini-image`)
|
||||
|
||||
OpenClaw 图像生成驱动模块,适配标准 **OpenAI Images API**(`/v1/images/generations` 及 `/v1/images/edits` 规范)。
|
||||
|
||||
专为自建聚合网关或第三方中转(如 `Bifrost`、`ccLoad`)定制打造:
|
||||
* **尺寸安全归一化**:修复官方驱动在反代环境下因 `16:9` 映射为 `2048x1152` 导致上游报 400 错误的 Bug(Issue #168665),自动将 `16:9` / `9:16` 适配为上游通用的安全比例规格(如 `1792x1024` / `1536x1024`)。
|
||||
* **格式双模自适应**:同时支持解析上游返回的 `b64_json`(Base64 内存直解码)与 `url`(自动安全下载并保存为本地 Buffer),彻底杜绝 `response malformed` 解析失败。
|
||||
* **图生图编辑支持**:当传入 `inputImages` 时,自动走 Multipart 表单发起编辑请求;纯文本生图时走轻量 JSON 请求。
|
||||
* **私有网络与反代直通**:原生支持私有/内网端点请求(`allowPrivateNetwork: true`),兼容 `127.0.0.1`、`host.incus.internal` 或自建反代网关。
|
||||
OpenClaw 图像生成驱动模块集合,根据上游协议严格分离为两个专职驱动,彻底杜绝跨协议调用引发的 400 错配。
|
||||
|
||||
---
|
||||
|
||||
## 标识符
|
||||
## 包含驱动一览
|
||||
|
||||
* **Provider ID**:`1h-image`
|
||||
* **默认模型**:`gpt-image-2`
|
||||
* **支持模型列表**:`gpt-image-2`, `gpt-image-1.5`, `gemini-3.1-flash-image`(也可在配置中自定义扩展)
|
||||
| Provider ID | 对应协议 | 默认模型 | 适用场景 / 支持模型 |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **`1h-openai-image`** | OpenAI 标准图像协议<br>(`POST /v1/images/generations`) | `gpt-image-2` | 专为号池/公益站的 OpenAI 协议图像生成打造:<br>• `gpt-image-2`<br>• `gpt-image-2.5`<br>• `gpt-image-2.5-flare`<br>• `gpt-image-2.5-sunburst` |
|
||||
| **`1h-gemini-image`** | Google Gemini 原生内容协议<br>(`POST /v1beta/models/...:generateContent`) | `gemini-3.1-flash-image` | 专为渠道 87(CLI-Proxy)的原生 Gemini 图像生成打造:<br>• `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 协议秒级接管。
|
||||
|
||||
---
|
||||
|
||||
## 配置说明
|
||||
|
||||
支持通过 **Web 控制台(Control UI)** 或直接编辑 `~/.openclaw/openclaw.json`。
|
||||
|
||||
### 方式 1:Web 控制台可视化配置
|
||||
进入 **Settings → Plugins → 1-h Tools**:
|
||||
* **Image Base URL**:填写图像上游端点(例如 `https://Direct-Bifrost.oo1.dev/v1` 或内部反代地址)
|
||||
* **Image API Key**:填写 API Key 或 SecretRef(留空时自动回退读取环境变量 `OPENAI_IMAGE_API_KEY`、`BIFROST_API_KEY`、`CCLOAD_API_KEY` 或 `OPENAI_API_KEY`)
|
||||
* **Default Image Model**:例如 `gpt-image-2`
|
||||
|
||||
### 方式 2:编辑 `openclaw.json`
|
||||
|
||||
在 `~/.openclaw/openclaw.json` 中配置:
|
||||
|
||||
```json5
|
||||
@@ -39,10 +37,17 @@ OpenClaw 图像生成驱动模块,适配标准 **OpenAI Images API**(`/v1/im
|
||||
"1h-tools": {
|
||||
"enabled": true,
|
||||
"config": {
|
||||
"image": {
|
||||
"baseUrl": "https://Direct-Bifrost.oo1.dev/v1",
|
||||
"apiKey": "sk-your-bifrost-key",
|
||||
"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
|
||||
}
|
||||
}
|
||||
@@ -53,9 +58,9 @@ OpenClaw 图像生成驱动模块,适配标准 **OpenAI Images API**(`/v1/im
|
||||
"defaults": {
|
||||
"mediaModels": {
|
||||
"image": {
|
||||
"primary": "1h-image/gpt-image-2",
|
||||
"primary": "1h-openai-image/gpt-image-2",
|
||||
"fallbacks": [
|
||||
"1h-image/gemini-3.1-flash-image"
|
||||
"1h-gemini-image/gemini-3.1-flash-image"
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -69,7 +74,5 @@ OpenClaw 图像生成驱动模块,适配标准 **OpenAI Images API**(`/v1/im
|
||||
## 使用方法
|
||||
|
||||
配置完成后,OpenClaw 内置的 `image_generate` 工具即可自动调度:
|
||||
* **文本生成图像**:
|
||||
> “生成一张 16:9 的秋日晨光现代书房桌面壁纸”
|
||||
* **垫图修改/编辑**:
|
||||
在对话中附带图片,提示助手基于该图进行风格调整或重绘。
|
||||
* **正常请求**:默认走 `1h-openai-image/gpt-image-2`;
|
||||
* **容灾回退**:若主模型超时(如公益站排队超时 499),系统自动使用纯正的 `1h-gemini-image/gemini-3.1-flash-image` 协议回退,绝不报 400。
|
||||
Reference in new issue
Block a user