feat(image): 以插件声明统一图片参数、尺寸选择与定价合同 (#760)
* feat(image): 图片参数 - 统一插件声明配置与生成合同 * docs(image): 图片参数 - 说明声明合同与验证边界 * fix(plugins): 图片声明 - 保留内联素材支持并同步制品文档 * fix(image): 参数合同 - 对齐审批意图和尺寸预检调用方 * fix(image): 调用链 - 保留公开意图并接通独立分辨率 * fix(image): 图片参数 - 补齐分辨率接线与目录价格投影
This commit is contained in:
1 parent
88de4ce422
commit
7466119867
104 files changed
+6013
-568
No files matched your search
@@ -81,6 +81,10 @@
|
||||
|
||||
imageSize 只映射 1K/2K/4K;未知质量值(如视频清晰度 720)必须省略。多图输出由宿主按次创建,不映射 candidateCount。
|
||||
|
||||
## 动态图片参数
|
||||
|
||||
`contributes.providers[].imageParameters` 是渠道模型、前台模型与生成界面共用的参数合同。`name` 为稳定身份,`type`、`values`、`min/max/step`、`default` 描述输入;`models` 限定适用上游模型,`enabled` 为初始启用状态。只有 `pricing: true` 的启用字段允许作为价格条件;其他参数仍参与生成。渠道可收窄范围,绑定与计价资格由插件拥有。`binding` 映射到统一请求或插件自己的 `providerOptions` 命名空间。
|
||||
|
||||
<!-- YINGCE_MANIFEST_CONTRACT_START -->
|
||||
## Manifest 完整接口定义
|
||||
|
||||
@@ -91,7 +95,7 @@ imageSize 只映射 1K/2K/4K;未知质量值(如视频清晰度 720)必须
|
||||
"apiVersion": "yingce.plugin/v2",
|
||||
"id": "google-gemini-image",
|
||||
"name": "Google Gemini Image",
|
||||
"version": "2.0.0",
|
||||
"version": "2.1.0",
|
||||
"author": "Google / 影策",
|
||||
"description": "Google Gemini Image 独立请求协议插件。",
|
||||
"documentation": "<当前插件的完整 documentation,由 README.md 与 docs/interface.md 拼接而成;为避免 JSON 递归,此处不重复展开正文。>",
|
||||
@@ -130,6 +134,67 @@ imageSize 只映射 1K/2K/4K;未知质量值(如视频清晰度 720)必须
|
||||
"type": "google-api-key",
|
||||
"field": "apiKey"
|
||||
},
|
||||
"imageParameters": [
|
||||
{
|
||||
"name": "size",
|
||||
"label": "画幅比例",
|
||||
"type": "string",
|
||||
"binding": "aspectRatio",
|
||||
"encoding": "ratio",
|
||||
"values": [
|
||||
"1:1",
|
||||
"2:3",
|
||||
"3:2",
|
||||
"3:4",
|
||||
"4:3",
|
||||
"4:5",
|
||||
"5:4",
|
||||
"9:16",
|
||||
"16:9",
|
||||
"21:9"
|
||||
],
|
||||
"default": "1:1"
|
||||
},
|
||||
{
|
||||
"name": "imageResolution",
|
||||
"label": "分辨率",
|
||||
"type": "string",
|
||||
"binding": "resolution",
|
||||
"values": [
|
||||
"1k",
|
||||
"2k",
|
||||
"4k"
|
||||
],
|
||||
"default": "1k",
|
||||
"pricing": true
|
||||
},
|
||||
{
|
||||
"name": "count",
|
||||
"label": "生成数量",
|
||||
"type": "integer",
|
||||
"binding": "imageCount",
|
||||
"min": 1,
|
||||
"max": 1,
|
||||
"step": 1,
|
||||
"default": 1
|
||||
},
|
||||
{
|
||||
"name": "seed",
|
||||
"label": "随机种子",
|
||||
"type": "integer",
|
||||
"binding": "providerOptions.gemini-image.seed",
|
||||
"enabled": false
|
||||
},
|
||||
{
|
||||
"name": "temperature",
|
||||
"label": "随机程度",
|
||||
"type": "number",
|
||||
"binding": "providerOptions.gemini-image.temperature",
|
||||
"min": 0,
|
||||
"max": 2,
|
||||
"enabled": false
|
||||
}
|
||||
],
|
||||
"parameters": [
|
||||
{
|
||||
"name": "model",
|
||||
|
||||
@@ -2,10 +2,10 @@
|
||||
"apiVersion": "yingce.plugin/v2",
|
||||
"id": "google-gemini-image",
|
||||
"name": "Google Gemini Image",
|
||||
"version": "2.0.0",
|
||||
"version": "2.1.0",
|
||||
"author": "Google / 影策",
|
||||
"description": "Google Gemini Image 独立请求协议插件。",
|
||||
"documentation": "# Google Gemini Image\n\n该目录是独立官方协议插件源码。后端从生成的 `google-gemini-image.yingce-plugin` 包加载,不依赖系统内置 `host:` 适配器。\n\n完整接口见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# Google Gemini Image 接口字段\n\n## 协议身份\n\n- 插件 ID:`google-gemini-image`。\n- Provider ID:`gemini-image`。\n- 能力:`image`。\n- 默认 Base URL:`https://generativelanguage.googleapis.com`。\n- 鉴权驱动:`google-api-key`。\n- 创建:`POST /v1beta/models/{{model}}:generateContent`。\n- 生命周期:同步响应。\n\n## 配置字段\n\n| 字段 | 类型 | 必填 | 含义 |\n| --- | --- | --- | --- |\n| `apiKey` | secret | 是 | API Key |\n\n## 统一字段映射\n\n| 统一字段 | 类型 | 必填 | 上游映射 | 说明 |\n| --- | --- | --- | --- | --- |\n| `model` | string | 是 | `model` | 图片模型 ID。 |\n| `prompt` | string | 是 | `prompt` | 图片提示词。 |\n| `images` | media[] | 否 | `provider image/reference fields` | 参考图或编辑源图,role 由业务层确定。 |\n| `imageCount` | integer | 否 | `n/sample_count` | 输出数量。 |\n| `aspectRatio` | string | 否 | `size/aspect_ratio` | 比例或尺寸,语义按协议说明。 |\n| `resolution` | string | 否 | `resolution/imageSize` | 分辨率档位。 |\n| `quality` | string | 否 | `quality` | 质量档位。 |\n| `providerOptions` | object | 否 | `provider-specific fields` | 插件命名空间内的厂商扩展字段。 |\n\n## 上游请求模板逐字段清单\n\n下表由插件请求模板生成,覆盖 body、query、headers 和 multipart 文件声明中的每个字段。\n\n| 上游位置 | 值或转换表达式 |\n| --- | --- |\n| `create.method` | `\"POST\"` |\n| `create.path` | `\"/v1beta/models/{{model}}:generateContent\"` |\n| `create.contentType` | `\"application/json\"` |\n| `create.body.contents[0].role` | `\"user\"` |\n| `create.body.contents[0].parts` | `{\"$concatArrays\":[[{\"text\":{\"$ref\":\"request.prompt\"}}],{\"$map\":{\"from\":{\"$ref\":\"request.images\"},\"as\":\"media\",\"in\":{\"$if\":{\"condition\":{\"$ref\":\"media.dataUrl\"},\"then\":{\"inlineData\":{\"mimeType\":{\"$dataMime\":{\"$ref\":\"media.dataUrl\"}},\"data\":{\"$dataPayload\":{\"$ref\":\"media.dataUrl\"}}}},\"else\":{\"fileData\":{\"mimeType\":{\"$omitEmpty\":{\"$ref\":\"media.mimeType\"}},\"fileUri\":{\"$ref\":\"media.url\"}}}}}}}]}` |\n| `create.body.generationConfig.responseModalities` | `{\"$coalesce\":[{\"$ref\":\"request.providerOptions.gemini-image.responseModalities\"},[\"TEXT\",\"IMAGE\"]]}` |\n| `create.body.generationConfig.imageConfig.aspectRatio` | `{\"$omitEmpty\":{\"$ref\":\"request.aspectRatio\"}}` |\n| `create.body.generationConfig.imageConfig.imageSize` | `{\"$omitEmpty\":{\"$coalesce\":[{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"1k\",\"low\"]]},\"then\":\"1K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"2k\",\"medium\"]]},\"then\":\"2K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"4k\",\"high\"]]},\"then\":\"4K\"}],\"default\":null}},{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"1k\",\"low\"]]},\"then\":\"1K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"2k\",\"medium\"]]},\"then\":\"2K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"4k\",\"high\"]]},\"then\":\"4K\"}],\"default\":null}}]}}` |\n| `create.body.generationConfig.temperature` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.temperature\"}}` |\n| `create.body.generationConfig.topP` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.topP\"}}` |\n| `create.body.generationConfig.topK` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.topK\"}}` |\n| `create.body.generationConfig.seed` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.seed\"}}` |\n| `create.body.safetySettings` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.safetySettings\"}}` |\n| `create.body.systemInstruction` | `{\"$omitEmpty\":{\"$coalesce\":[{\"$ref\":\"request.providerOptions.gemini-image.systemInstruction\"},{\"$if\":{\"condition\":{\"$ref\":\"request.instructions\"},\"then\":{\"parts\":[{\"text\":{\"$ref\":\"request.instructions\"}}]},\"else\":null}}]}}` |\n\n## Provider 扩展键\n\n- `providerOptions.gemini-image.responseModalities`\n- `providerOptions.gemini-image.safetySettings`\n- `providerOptions.gemini-image.seed`\n- `providerOptions.gemini-image.systemInstruction`\n- `providerOptions.gemini-image.temperature`\n- `providerOptions.gemini-image.topK`\n- `providerOptions.gemini-image.topP`\n\n动态模型或工作流允许使用文档声明的完整 `parameters/input/extra_body` 对象;该对象是协议本身的开放 schema,不会被宿主裁剪。\n\n## 响应映射逐字段清Line truncated
|
||||
"documentation": "# Google Gemini Image\n\n该目录是独立官方协议插件源码。后端从生成的 `google-gemini-image.yingce-plugin` 包加载,不依赖系统内置 `host:` 适配器。\n\n完整接口见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# Google Gemini Image 接口字段\n\n## 协议身份\n\n- 插件 ID:`google-gemini-image`。\n- Provider ID:`gemini-image`。\n- 能力:`image`。\n- 默认 Base URL:`https://generativelanguage.googleapis.com`。\n- 鉴权驱动:`google-api-key`。\n- 创建:`POST /v1beta/models/{{model}}:generateContent`。\n- 生命周期:同步响应。\n\n## 配置字段\n\n| 字段 | 类型 | 必填 | 含义 |\n| --- | --- | --- | --- |\n| `apiKey` | secret | 是 | API Key |\n\n## 统一字段映射\n\n| 统一字段 | 类型 | 必填 | 上游映射 | 说明 |\n| --- | --- | --- | --- | --- |\n| `model` | string | 是 | `model` | 图片模型 ID。 |\n| `prompt` | string | 是 | `prompt` | 图片提示词。 |\n| `images` | media[] | 否 | `provider image/reference fields` | 参考图或编辑源图,role 由业务层确定。 |\n| `imageCount` | integer | 否 | `n/sample_count` | 输出数量。 |\n| `aspectRatio` | string | 否 | `size/aspect_ratio` | 比例或尺寸,语义按协议说明。 |\n| `resolution` | string | 否 | `resolution/imageSize` | 分辨率档位。 |\n| `quality` | string | 否 | `quality` | 质量档位。 |\n| `providerOptions` | object | 否 | `provider-specific fields` | 插件命名空间内的厂商扩展字段。 |\n\n## 上游请求模板逐字段清单\n\n下表由插件请求模板生成,覆盖 body、query、headers 和 multipart 文件声明中的每个字段。\n\n| 上游位置 | 值或转换表达式 |\n| --- | --- |\n| `create.method` | `\"POST\"` |\n| `create.path` | `\"/v1beta/models/{{model}}:generateContent\"` |\n| `create.contentType` | `\"application/json\"` |\n| `create.body.contents[0].role` | `\"user\"` |\n| `create.body.contents[0].parts` | `{\"$concatArrays\":[[{\"text\":{\"$ref\":\"request.prompt\"}}],{\"$map\":{\"from\":{\"$ref\":\"request.images\"},\"as\":\"media\",\"in\":{\"$if\":{\"condition\":{\"$ref\":\"media.dataUrl\"},\"then\":{\"inlineData\":{\"mimeType\":{\"$dataMime\":{\"$ref\":\"media.dataUrl\"}},\"data\":{\"$dataPayload\":{\"$ref\":\"media.dataUrl\"}}}},\"else\":{\"fileData\":{\"mimeType\":{\"$omitEmpty\":{\"$ref\":\"media.mimeType\"}},\"fileUri\":{\"$ref\":\"media.url\"}}}}}}}]}` |\n| `create.body.generationConfig.responseModalities` | `{\"$coalesce\":[{\"$ref\":\"request.providerOptions.gemini-image.responseModalities\"},[\"TEXT\",\"IMAGE\"]]}` |\n| `create.body.generationConfig.imageConfig.aspectRatio` | `{\"$omitEmpty\":{\"$ref\":\"request.aspectRatio\"}}` |\n| `create.body.generationConfig.imageConfig.imageSize` | `{\"$omitEmpty\":{\"$coalesce\":[{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"1k\",\"low\"]]},\"then\":\"1K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"2k\",\"medium\"]]},\"then\":\"2K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.quality\"}},[\"4k\",\"high\"]]},\"then\":\"4K\"}],\"default\":null}},{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"1k\",\"low\"]]},\"then\":\"1K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"2k\",\"medium\"]]},\"then\":\"2K\"},{\"when\":{\"$in\":[{\"$lower\":{\"$ref\":\"request.resolution\"}},[\"4k\",\"high\"]]},\"then\":\"4K\"}],\"default\":null}}]}}` |\n| `create.body.generationConfig.temperature` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.temperature\"}}` |\n| `create.body.generationConfig.topP` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.topP\"}}` |\n| `create.body.generationConfig.topK` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.topK\"}}` |\n| `create.body.generationConfig.seed` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.seed\"}}` |\n| `create.body.safetySettings` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.gemini-image.safetySettings\"}}` |\n| `create.body.systemInstruction` | `{\"$omitEmpty\":{\"$coalesce\":[{\"$ref\":\"request.providerOptions.gemini-image.systemInstruction\"},{\"$if\":{\"condition\":{\"$ref\":\"request.instructions\"},\"then\":{\"parts\":[{\"text\":{\"$ref\":\"request.instructions\"}}]},\"else\":null}}]}}` |\n\n## Provider 扩展键\n\n- `providerOptions.gemini-image.responseModalities`\n- `providerOptions.gemini-image.safetySettings`\n- `providerOptions.gemini-image.seed`\n- `providerOptions.gemini-image.systemInstruction`\n- `providerOptions.gemini-image.temperature`\n- `providerOptions.gemini-image.topK`\n- `providerOptions.gemini-image.topP`\n\n动态模型或工作流允许使用文档声明的完整 `parameters/input/extra_body` 对象;该对象是协议本身的开放 schema,不会被宿主裁剪。\n\n## 响应映射逐字段清Line truncated
|
||||
"permissions": [
|
||||
"generation.run",
|
||||
"media.read"
|
||||
@@ -41,6 +41,67 @@
|
||||
"type": "google-api-key",
|
||||
"field": "apiKey"
|
||||
},
|
||||
"imageParameters": [
|
||||
{
|
||||
"name": "size",
|
||||
"label": "画幅比例",
|
||||
"type": "string",
|
||||
"binding": "aspectRatio",
|
||||
"encoding": "ratio",
|
||||
"values": [
|
||||
"1:1",
|
||||
"2:3",
|
||||
"3:2",
|
||||
"3:4",
|
||||
"4:3",
|
||||
"4:5",
|
||||
"5:4",
|
||||
"9:16",
|
||||
"16:9",
|
||||
"21:9"
|
||||
],
|
||||
"default": "1:1"
|
||||
},
|
||||
{
|
||||
"name": "imageResolution",
|
||||
"label": "分辨率",
|
||||
"type": "string",
|
||||
"binding": "resolution",
|
||||
"values": [
|
||||
"1k",
|
||||
"2k",
|
||||
"4k"
|
||||
],
|
||||
"default": "1k",
|
||||
"pricing": true
|
||||
},
|
||||
{
|
||||
"name": "count",
|
||||
"label": "生成数量",
|
||||
"type": "integer",
|
||||
"binding": "imageCount",
|
||||
"min": 1,
|
||||
"max": 1,
|
||||
"step": 1,
|
||||
"default": 1
|
||||
},
|
||||
{
|
||||
"name": "seed",
|
||||
"label": "随机种子",
|
||||
"type": "integer",
|
||||
"binding": "providerOptions.gemini-image.seed",
|
||||
"enabled": false
|
||||
},
|
||||
{
|
||||
"name": "temperature",
|
||||
"label": "随机程度",
|
||||
"type": "number",
|
||||
"binding": "providerOptions.gemini-image.temperature",
|
||||
"min": 0,
|
||||
"max": 2,
|
||||
"enabled": false
|
||||
}
|
||||
],
|
||||
"parameters": [
|
||||
{
|
||||
"name": "model",
|
||||
|
||||
Reference in new issue
Block a user