{ "apiVersion": "yingce.plugin/v2", "id": "xai-grok-images", "name": "xAI Grok Images", "version": "2.0.0", "author": "xAI / 影策", "description": "xAI Grok Images 独立请求协议插件。", "documentation": "# xAI Grok Images\n\n该目录是独立官方协议插件源码。后端从生成的 `xai-grok-images.yingce-plugin` 包加载,不依赖系统内置 `host:` 适配器。\n\n完整接口见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# xAI Grok Images 接口字段\n\n## 协议身份\n\n- 插件 ID:`xai-grok-images`。\n- Provider ID:`grok-image`。\n- 能力:`image`。\n- 默认 Base URL:`https://api.x.ai`。\n- 鉴权驱动:`bearer`。\n- 创建:`POST /v1/images/generations`。\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` | `\"/v1/images/generations\"` |\n| `create.contentType` | `\"application/json\"` |\n| `create.body.model` | `{\"$ref\":\"request.model\"}` |\n| `create.body.prompt` | `{\"$ref\":\"request.prompt\"}` |\n| `create.body.image` | `{\"$if\":{\"condition\":{\"$gt\":[{\"$len\":{\"$ref\":\"request.images\"}},0]},\"then\":{\"url\":{\"$first\":{\"$map\":{\"from\":{\"$filter\":{\"from\":{\"$sortByOrder\":{\"$ref\":\"request.images\"}},\"as\":\"media\",\"where\":{\"$in\":[{\"$ref\":\"media.role\"},[\"edit_source\",\"reference_image\",\"\"]]}}},\"as\":\"media\",\"in\":{\"$ref\":\"media.value\"}}}}},\"else\":null}}` |\n| `create.body.n` | `{\"$if\":{\"condition\":{\"$gt\":[{\"$ref\":\"request.imageCount\"},0]},\"then\":{\"$ref\":\"request.imageCount\"},\"else\":1}}` |\n| `create.body.response_format` | `{\"$coalesce\":[{\"$ref\":\"request.providerOptions.grok-image.response_format\"},\"url\"]}` |\n| `create.body.aspect_ratio` | `{\"$omitEmpty\":{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},[\"\",\"auto\"]]},\"then\":null},{\"when\":{\"$in\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},[\"1:1\",\"3:4\",\"4:3\",\"9:16\",\"16:9\",\"2:3\",\"3:2\",\"9:19.5\",\"19.5:9\",\"1:2\",\"2:1\"]]},\"then\":{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}}},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$eq\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]}]},\"then\":\"1:1\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gte\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.7]},{\"$lte\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.8]}]},\"then\":\"16:9\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gte\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.5555555555555556]},{\"$lte\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.5882352941176471]}]},\"then\":\"9:16\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.2]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.4]}]},\"then\":\"4:3\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.7]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.85]}]},\"then\":\"3:4\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gte\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.6]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.72]}]},\"then\":\"2:3\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.35]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.6]}]},\"then\":\"3:2\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.45]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},0.55]}]},\"then\":\"1:2\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},1.85]},{\"$lt\":[{\"$divide\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]},2.2]}]},\"then\":\"2:1\"},{\"when\":{\"$and\":[{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}}]}]},\"then\":\"16:9\"},{\"when\":{\"$and\":[{\"$eq\":[{\"$len\":{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]}},2]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},0]}},0]},{\"$gt\":[{\"$toFloat\":{\"$at\":[{\"$split\":[{\"$lower\":{\"$trim\":{\"$ref\":\"request.aspectRatio\"}}},\"x\"]},1]}},0]}]},\"then\":\"9:16\"}],\"default\":null}}}` |\n| `create.body.resolution` | `{\"$omitEmpty\":{\"$switch\":{\"cases\":[{\"when\":{\"$in\":[{\"$lower\":{\"$trim\":{\"$coalesce\":[{\"$ref\":\"request.resolution\"},{\"$ref\":\"request.quality\"}]}}},[\"1k\",\"low\",\"standard\"]]},\"then\":\"1k\"},{\"when\":{\"$in\":[{\"$lower\":{\"$trim\":{\"$coalesce\":[{\"$ref\":\"request.resolution\"},{\"$ref\":\"request.quality\"}]}}},[\"2k\",\"medium\",\"hd\",\"high\",\"4k\"]]},\"then\":\"2k\"}],\"default\":null}}}` |\n| `create.body.user` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.grok-image.user\"}}` |\n\n## Provider 扩展键\n\n- `providerOptions.grok-image.response_format`\n- `providerOptions.grok-image.user`\n\n动态模型或工作流允许使用文档声明的完整 `parameters/input/extra_body` 对象;该对象是协议本身的开放 schema,不会被宿主裁剪。\n\n## 响应映射逐字段清单\n\n| 映射位置 | 上游路径或转换表达式 |\n| --- | --- |\n| `response.status` | `\"succeeded\"` |\n| `response.images` | `{\"$map\":{\"from\":{\"$ref\":\"response.data\"},\"as\":\"item\",\"in\":{\"url\":{\"$omitEmpty\":{\"$ref\":\"item.url\"}},\"dataUrl\":{\"$if\":{\"condition\":{\"$ref\":\"item.b64_json\"},\"then\":{\"$concat\":[\"data:image/png;base64,\",{\"$ref\":\"item.b64_json\"}]},\"else\":null}}}}}` |\n| `response.errorPaths[0]` | `\"error.code\"` |\n| `response.messagePaths[0]` | `\"error.message\"` |\n\n## 响应与错误\n\n插件把上游 task/status/text/media/usage 映射为统一结果。临时媒体 URL 标记为 ephemeral,由宿主立即下载持久化。HTTP 错误、业务 code 和 error object 保持失败语义,不包装成成功。\n\n## 兼容边界\n\n有参考图时改走 /v1/images/edits;resolution 只接受 1k/2k;像素尺寸会换算为 aspect_ratio。\n\n\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致,覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档;为避免文档在自身内部无限递归,JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n \"apiVersion\": \"yingce.plugin/v2\",\n \"id\": \"xai-grok-images\",\n \"name\": \"xAI Grok Images\",\n \"version\": \"2.0.0\",\n \"author\": \"xAI / 影策\",\n \"description\": \"xAI Grok Images 独立请求协议插件。\",\n \"documentation\": \"<当前插件的完整 documentation,由 README.md 与 docs/interface.md 拼接而成;为避免 JSON 递归,此处不重复展开正文。>\",\n \"permissions\": [\n \"generation.run\",\n \"media.read\"\n ],\n \"configuration\": {\n \"fields\": [\n {\n \"name\": \"apiKey\",\n \"type\": \"secret\",\n \"label\": \"API Key\",\n \"required\": true\n }\n ]\n },\n \"contributes\": {\n \"providers\": [\n {\n \"id\": \"grok-image\",\n \"label\": \"xAI Grok Images\",\n \"capabilities\": [\n \"image\"\n ],\n \"scopes\": [\n \"admin.system-channel\",\n \"user.custom-channel\",\n \"canvas\",\n \"creation\",\n \"agent\"\n ],\n \"baseUrl\": \"https://api.x.ai\",\n \"requiresPublicMediaUrls\": false,\n \"auth\": {\n \"type\": \"bearer\",\n \"field\": \"apiKey\"\n },\n \"parameters\": [\n {\n \"name\": \"model\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"model\",\n \"description\": \"图片模型 ID。\"\n },\n {\n \"name\": \"prompt\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"prompt\",\n \"description\": \"图片提示词。\"\n },\n {\n \"name\": \"images\",\n \"type\": \"media[]\",\n \"required\": false,\n \"mapping\": \"provider image/reference fields\",\n \"description\": \"参考图或编辑源图,role 由业务层确定。\"\n },\n {\n \"name\": \"imageCount\",\n \"type\": \"integer\",\n \"required\": false,\n \"mapping\": \"n/sample_count\",\n \"description\": \"输出数量。\"\n },\n {\n \"name\": \"aspectRatio\",\n \"type\": \"string\",\n \"required\": false,\n \"mapping\": \"size/aspect_ratio\",\n \"description\": \"比例或尺寸,语义按协议说明。\"\n },\n {\n \"name\": \"resolution\",\n \"type\": \"string\",\n \"required\": false,\n \"mapping\": \"resolution/imageSize\",\n \"description\": \"分辨率档位。\"\n },\n {\n \"name\": \"quality\",\n \"type\": \"string\",\n \"required\": false,\n \"mapping\": \"quality\",\n \"description\": \"质量档位。\"\n },\n {\n \"name\": \"providerOptions\",\n \"type\": \"object\",\n \"required\": false,\n \"mapping\": \"provider-specific fields\",\n \"description\": \"插件命名空间内的厂商扩展字段。\"\n }\n ],\n \"create\": {\n \"method\": \"POST\",\n \"path\": \"/v1/images/generations\",\n \"pathTemplate\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$ref\": \"request.images\"\n }\n },\n 0\n ]\n },\n \"then\": \"/v1/images/edits\",\n \"else\": \"/v1/images/generations\"\n }\n },\n \"contentType\": \"application/json\",\n \"body\": {\n \"model\": {\n \"$ref\": \"request.model\"\n },\n \"prompt\": {\n \"$ref\": \"request.prompt\"\n },\n \"image\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$ref\": \"request.images\"\n }\n },\n 0\n ]\n },\n \"then\": {\n \"url\": {\n \"$first\": {\n \"$map\": {\n \"from\": {\n \"$filter\": {\n \"from\": {\n \"$sortByOrder\": {\n \"$ref\": \"request.images\"\n }\n },\n \"as\": \"media\",\n \"where\": {\n \"$in\": [\n {\n \"$ref\": \"media.role\"\n },\n [\n \"edit_source\",\n \"reference_image\",\n \"\"\n ]\n ]\n }\n }\n },\n \"as\": \"media\",\n \"in\": {\n \"$ref\": \"media.value\"\n }\n }\n }\n }\n },\n \"else\": null\n }\n },\n \"n\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$ref\": \"request.imageCount\"\n },\n 0\n ]\n },\n \"then\": {\n \"$ref\": \"request.imageCount\"\n },\n \"else\": 1\n }\n },\n \"response_format\": {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.grok-image.response_format\"\n },\n \"url\"\n ]\n },\n \"aspect_ratio\": {\n \"$omitEmpty\": {\n \"$switch\": {\n \"cases\": [\n {\n \"when\": {\n \"$in\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n [\n \"\",\n \"auto\"\n ]\n ]\n },\n \"then\": null\n },\n {\n \"when\": {\n \"$in\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n [\n \"1:1\",\n \"3:4\",\n \"4:3\",\n \"9:16\",\n \"16:9\",\n \"2:3\",\n \"3:2\",\n \"9:19.5\",\n \"19.5:9\",\n \"1:2\",\n \"2:1\"\n ]\n ]\n },\n \"then\": {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n }\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$eq\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n }\n ]\n },\n \"then\": \"1:1\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gte\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.7\n ]\n },\n {\n \"$lte\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.8\n ]\n }\n ]\n },\n \"then\": \"16:9\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gte\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.5555555555555556\n ]\n },\n {\n \"$lte\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.5882352941176471\n ]\n }\n ]\n },\n \"then\": \"9:16\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.2\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.4\n ]\n }\n ]\n },\n \"then\": \"4:3\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.7\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.85\n ]\n }\n ]\n },\n \"then\": \"3:4\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gte\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.6\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.72\n ]\n }\n ]\n },\n \"then\": \"2:3\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.35\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.6\n ]\n }\n ]\n },\n \"then\": \"3:2\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.45\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 0.55\n ]\n }\n ]\n },\n \"then\": \"1:2\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 1.85\n ]\n },\n {\n \"$lt\": [\n {\n \"$divide\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n },\n 2.2\n ]\n }\n ]\n },\n \"then\": \"2:1\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n }\n ]\n }\n ]\n },\n \"then\": \"16:9\"\n },\n {\n \"when\": {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n }\n },\n 2\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 0\n ]\n }\n },\n 0\n ]\n },\n {\n \"$gt\": [\n {\n \"$toFloat\": {\n \"$at\": [\n {\n \"$split\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"x\"\n ]\n },\n 1\n ]\n }\n },\n 0\n ]\n }\n ]\n },\n \"then\": \"9:16\"\n }\n ],\n \"default\": null\n }\n }\n },\n \"resolution\": {\n \"$omitEmpty\": {\n \"$switch\": {\n \"cases\": [\n {\n \"when\": {\n \"$in\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$coalesce\": [\n {\n \"$ref\": \"request.resolution\"\n },\n {\n \"$ref\": \"request.quality\"\n }\n ]\n }\n }\n },\n [\n \"1k\",\n \"low\",\n \"standard\"\n ]\n ]\n },\n \"then\": \"1k\"\n },\n {\n \"when\": {\n \"$in\": [\n {\n \"$lower\": {\n \"$trim\": {\n \"$coalesce\": [\n {\n \"$ref\": \"request.resolution\"\n },\n {\n \"$ref\": \"request.quality\"\n }\n ]\n }\n }\n },\n [\n \"2k\",\n \"medium\",\n \"hd\",\n \"high\",\n \"4k\"\n ]\n ]\n },\n \"then\": \"2k\"\n }\n ],\n \"default\": null\n }\n }\n },\n \"user\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.grok-image.user\"\n }\n }\n }\n },\n \"response\": {\n \"status\": \"succeeded\",\n \"images\": {\n \"$map\": {\n \"from\": {\n \"$ref\": \"response.data\"\n },\n \"as\": \"item\",\n \"in\": {\n \"url\": {\n \"$omitEmpty\": {\n \"$ref\": \"item.url\"\n }\n },\n \"dataUrl\": {\n \"$if\": {\n \"condition\": {\n \"$ref\": \"item.b64_json\"\n },\n \"then\": {\n \"$concat\": [\n \"data:image/png;base64,\",\n {\n \"$ref\": \"item.b64_json\"\n }\n ]\n },\n \"else\": null\n }\n }\n }\n }\n },\n \"errorPaths\": [\n \"error.code\"\n ],\n \"messagePaths\": [\n \"error.message\"\n ]\n }\n }\n ]\n }\n}\n```\n\n", "permissions": [ "generation.run", "media.read" ], "configuration": { "fields": [ { "name": "apiKey", "type": "secret", "label": "API Key", "required": true } ] }, "contributes": { "providers": [ { "id": "grok-image", "label": "xAI Grok Images", "capabilities": [ "image" ], "scopes": [ "admin.system-channel", "user.custom-channel", "canvas", "creation", "agent" ], "baseUrl": "https://api.x.ai", "requiresPublicMediaUrls": false, "auth": { "type": "bearer", "field": "apiKey" }, "parameters": [ { "name": "model", "type": "string", "required": true, "mapping": "model", "description": "图片模型 ID。" }, { "name": "prompt", "type": "string", "required": true, "mapping": "prompt", "description": "图片提示词。" }, { "name": "images", "type": "media[]", "required": false, "mapping": "provider image/reference fields", "description": "参考图或编辑源图,role 由业务层确定。" }, { "name": "imageCount", "type": "integer", "required": false, "mapping": "n/sample_count", "description": "输出数量。" }, { "name": "aspectRatio", "type": "string", "required": false, "mapping": "size/aspect_ratio", "description": "比例或尺寸,语义按协议说明。" }, { "name": "resolution", "type": "string", "required": false, "mapping": "resolution/imageSize", "description": "分辨率档位。" }, { "name": "quality", "type": "string", "required": false, "mapping": "quality", "description": "质量档位。" }, { "name": "providerOptions", "type": "object", "required": false, "mapping": "provider-specific fields", "description": "插件命名空间内的厂商扩展字段。" } ], "create": { "method": "POST", "path": "/v1/images/generations", "pathTemplate": { "$if": { "condition": { "$gt": [ { "$len": { "$ref": "request.images" } }, 0 ] }, "then": "/v1/images/edits", "else": "/v1/images/generations" } }, "contentType": "application/json", "body": { "model": { "$ref": "request.model" }, "prompt": { "$ref": "request.prompt" }, "image": { "$if": { "condition": { "$gt": [ { "$len": { "$ref": "request.images" } }, 0 ] }, "then": { "url": { "$first": { "$map": { "from": { "$filter": { "from": { "$sortByOrder": { "$ref": "request.images" } }, "as": "media", "where": { "$in": [ { "$ref": "media.role" }, [ "edit_source", "reference_image", "" ] ] } } }, "as": "media", "in": { "$ref": "media.value" } } } } }, "else": null } }, "n": { "$if": { "condition": { "$gt": [ { "$ref": "request.imageCount" }, 0 ] }, "then": { "$ref": "request.imageCount" }, "else": 1 } }, "response_format": { "$coalesce": [ { "$ref": "request.providerOptions.grok-image.response_format" }, "url" ] }, "aspect_ratio": { "$omitEmpty": { "$switch": { "cases": [ { "when": { "$in": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, [ "", "auto" ] ] }, "then": null }, { "when": { "$in": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, [ "1:1", "3:4", "4:3", "9:16", "16:9", "2:3", "3:2", "9:19.5", "19.5:9", "1:2", "2:1" ] ] }, "then": { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } } }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$eq": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] } ] }, "then": "1:1" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gte": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.7 ] }, { "$lte": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.8 ] } ] }, "then": "16:9" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gte": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.5555555555555556 ] }, { "$lte": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.5882352941176471 ] } ] }, "then": "9:16" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.2 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.4 ] } ] }, "then": "4:3" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.7 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.85 ] } ] }, "then": "3:4" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gte": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.6 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.72 ] } ] }, "then": "2:3" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.35 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.6 ] } ] }, "then": "3:2" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.45 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 0.55 ] } ] }, "then": "1:2" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 1.85 ] }, { "$lt": [ { "$divide": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] }, 2.2 ] } ] }, "then": "2:1" }, { "when": { "$and": [ { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } } ] } ] }, "then": "16:9" }, { "when": { "$and": [ { "$eq": [ { "$len": { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] } }, 2 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 0 ] } }, 0 ] }, { "$gt": [ { "$toFloat": { "$at": [ { "$split": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, "x" ] }, 1 ] } }, 0 ] } ] }, "then": "9:16" } ], "default": null } } }, "resolution": { "$omitEmpty": { "$switch": { "cases": [ { "when": { "$in": [ { "$lower": { "$trim": { "$coalesce": [ { "$ref": "request.resolution" }, { "$ref": "request.quality" } ] } } }, [ "1k", "low", "standard" ] ] }, "then": "1k" }, { "when": { "$in": [ { "$lower": { "$trim": { "$coalesce": [ { "$ref": "request.resolution" }, { "$ref": "request.quality" } ] } } }, [ "2k", "medium", "hd", "high", "4k" ] ] }, "then": "2k" } ], "default": null } } }, "user": { "$omitEmpty": { "$ref": "request.providerOptions.grok-image.user" } } } }, "response": { "status": "succeeded", "images": { "$map": { "from": { "$ref": "response.data" }, "as": "item", "in": { "url": { "$omitEmpty": { "$ref": "item.url" } }, "dataUrl": { "$if": { "condition": { "$ref": "item.b64_json" }, "then": { "$concat": [ "data:image/png;base64,", { "$ref": "item.b64_json" } ] }, "else": null } } } } }, "errorPaths": [ "error.code" ], "messagePaths": [ "error.message" ] } } ] } }