{ "apiVersion": "yingce.plugin/v2", "id": "cangyuan-midjourney", "name": "沧元 Midjourney", "version": "1.0.0", "author": "沧元算力 / 影绘", "description": "独立适配 V7 与默认 V8.2 的 1K/2K 线路，按供应商合同创建、查询并提取全部图片。", "enabled": true, "installable": true, "permissions": [ "generation.run", "media.read" ], "configuration": { "fields": [ { "name": "apiKey", "type": "secret", "label": "API Key", "required": true } ] }, "contributes": { "providers": [ { "id": "cangyuan-midjourney-v7", "label": "沧元 Midjourney V7", "capabilities": [ "image" ], "scopes": [ "admin.system-channel", "user.custom-channel", "canvas", "creation", "agent" ], "baseUrl": "https://ai.cangyuansuanli.cn/v1", "requiresPublicMediaUrls": true, "auth": { "type": "bearer", "field": "apiKey" }, "parameters": [ { "name": "model", "type": "string", "required": true, "mapping": "model", "description": "供应商公开模型名；两条线路分别校验。" }, { "name": "prompt", "type": "string", "required": true, "mapping": "prompt", "description": "原提示词；1K/2K 默认 V8.2，可写官网 --v / --niji 参数；V7 不支持这些版本参数。" }, { "name": "images", "type": "media[]", "mapping": "images[] / mask", "description": "按宿主显式 role 转换为 HTTPS URL 字符串数组；mask 单独映射。" }, { "name": "imageCount", "type": "integer", "mapping": "n=1", "description": "一次提交只能为 1，结果 data 可能含多张，全部保存。" }, { "name": "aspectRatio", "type": "string", "mapping": "size", "description": "比例或 V7 宽x高；空值和 auto 不发送，沿用供应商默认值。" }, { "name": "providerOptions", "type": "object", "mapping": "cangyuan-midjourney-v82.speed/reference", "description": "1K/2K 插件命名空间可指定 speed=relax/fast、reference=image/style/edit/moodboard/editor。V7 没有速度或版本扩展字段。" } ], "validations": [ { "assert": { "$in": [ { "$ref": "request.model" }, [ "midjourney-v7" ] ] }, "message": "模型名与 Midjourney 线路不匹配。" }, { "assert": { "$lte": [ { "$ref": "request.imageCount" }, 1 ] }, "message": "Midjourney 一次提交 n 只能为 1；返回多张图片会全部保存。" }, { "assert": { "$gt": [ { "$len": { "$trim": { "$ref": "request.prompt" } } }, 0 ] }, "message": "Midjourney 提示词不能为空。" }, { "assert": { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$first": { "$split": [ { "$ref": "media.value" }, ":" ] } }, "https" ] } } } }, 0 ] }, "message": "Midjourney 参考图和蒙版必须是 HTTPS URL，不能发送本地文件或 data URI。" }, { "assert": { "$lte": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 5 ] }, "message": "Midjourney V7 参考图最多 5 张。" }, { "assert": { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "message": "Midjourney V7 线路不支持蒙版。" }, { "assert": { "$lte": [ { "$len": { "$ref": "request.prompt" } }, 4000 ] }, "message": "Midjourney V7 提示词最多 4000 字符。" } ], "create": { "method": "POST", "path": "/v1/images/generations", "contentType": "application/json", "body": { "model": { "$ref": "request.model" }, "prompt": { "$ref": "request.prompt" }, "n": 1, "size": { "$if": { "condition": { "$in": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, [ "", "auto" ] ] }, "then": null, "else": { "$ref": "request.aspectRatio" } } }, "images": { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": { "$map": { "from": { "$sortByOrder": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, "as": "media", "in": { "$ref": "media.value" } } }, "else": null } }, "response_format": "url", "async": false }, "pathTemplate": { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": "/v1/images/edits", "else": "/v1/images/generations" } } }, "poll": { "method": "GET", "path": "/v1/images/generations/{{taskId}}", "pathTemplate": { "$concat": [ { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": "/v1/images/edits", "else": "/v1/images/generations" } }, "/", { "$ref": "taskId" } ] } }, "response": { "taskIdPaths": [ "id", "task_id" ], "statusPaths": [ "status" ], "errorPaths": [ "error.code" ], "messagePaths": [ "error.message", "message" ], "images": { "$map": { "from": { "$ref": "response.data" }, "as": "item", "in": { "url": { "$ref": "item.url" } } } }, "usage": { "$ref": "response.usage" } } }, { "id": "cangyuan-midjourney-v82", "label": "沧元 Midjourney 1K/2K · V8.2", "capabilities": [ "image" ], "scopes": [ "admin.system-channel", "user.custom-channel", "canvas", "creation", "agent" ], "baseUrl": "https://ai.cangyuansuanli.cn/v1", "requiresPublicMediaUrls": true, "auth": { "type": "bearer", "field": "apiKey" }, "parameters": [ { "name": "model", "type": "string", "required": true, "mapping": "model", "description": "供应商公开模型名；两条线路分别校验。" }, { "name": "prompt", "type": "string", "required": true, "mapping": "prompt", "description": "原提示词；1K/2K 默认 V8.2，可写官网 --v / --niji 参数；V7 不支持这些版本参数。" }, { "name": "images", "type": "media[]", "mapping": "images[] / mask", "description": "按宿主显式 role 转换为 HTTPS URL 字符串数组；mask 单独映射。" }, { "name": "imageCount", "type": "integer", "mapping": "n=1", "description": "一次提交只能为 1，结果 data 可能含多张，全部保存。" }, { "name": "aspectRatio", "type": "string", "mapping": "size", "description": "比例或 V7 宽x高；空值和 auto 不发送，沿用供应商默认值。" }, { "name": "providerOptions", "type": "object", "mapping": "cangyuan-midjourney-v82.speed/reference", "description": "1K/2K 插件命名空间可指定 speed=relax/fast、reference=image/style/edit/moodboard/editor。V7 没有速度或版本扩展字段。" } ], "validations": [ { "assert": { "$in": [ { "$ref": "request.model" }, [ "midjourney-1k", "midjourney-2k" ] ] }, "message": "模型名与 Midjourney 线路不匹配。" }, { "assert": { "$lte": [ { "$ref": "request.imageCount" }, 1 ] }, "message": "Midjourney 一次提交 n 只能为 1；返回多张图片会全部保存。" }, { "assert": { "$gt": [ { "$len": { "$trim": { "$ref": "request.prompt" } } }, 0 ] }, "message": "Midjourney 提示词不能为空。" }, { "assert": { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$first": { "$split": [ { "$ref": "media.value" }, ":" ] } }, "https" ] } } } }, 0 ] }, "message": "Midjourney 参考图和蒙版必须是 HTTPS URL，不能发送本地文件或 data URI。" }, { "assert": { "$in": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.speed" }, "relax" ] }, [ "relax", "fast" ] ] }, "message": "Midjourney speed 只支持 relax 或 fast。" }, { "assert": { "$in": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, [ "image", "style", "edit", "moodboard", "editor" ] ] }, "message": "Midjourney reference 类型无效。" }, { "assert": { "$or": [ { "$not": { "$eq": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "editor" ] } }, { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 1 ] } ] }, "message": "Midjourney editor 只能有一张源图。" }, { "assert": { "$or": [ { "$ne": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "edit" ] }, { "$lte": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 4 ] } ] }, "message": "Midjourney edit 参考图最多 4 张。" }, { "assert": { "$lte": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "mask" ] } } } }, 1 ] }, "message": "Midjourney 蒙版只能有一张。" }, { "assert": { "$or": [ { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, { "$and": [ { "$eq": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "editor" ] }, { "$eq": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 1 ] } ] } ] }, "message": "蒙版只能用于 editor，且必须有一张源图。" } ], "create": { "method": "POST", "path": "/v1/images/generations", "contentType": "application/json", "body": { "model": { "$ref": "request.model" }, "prompt": { "$ref": "request.prompt" }, "n": 1, "size": { "$if": { "condition": { "$in": [ { "$lower": { "$trim": { "$ref": "request.aspectRatio" } } }, [ "", "auto" ] ] }, "then": null, "else": { "$ref": "request.aspectRatio" } } }, "images": { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": { "$map": { "from": { "$sortByOrder": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, "as": "media", "in": { "$ref": "media.value" } } }, "else": null } }, "response_format": "url", "async": false, "speed": { "$omitEmpty": { "$ref": "request.providerOptions.cangyuan-midjourney-v82.speed" } }, "reference": { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "else": null } }, "mask": { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, "then": { "$first": { "$map": { "from": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "mask" ] } } }, "as": "media", "in": { "$ref": "media.value" } } } }, "else": null } } }, "pathTemplate": { "$if": { "condition": { "$and": [ { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, { "$eq": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "editor" ] } ] }, "then": "/v1/images/edits", "else": "/v1/images/generations" } } }, "poll": { "method": "GET", "path": "/v1/images/generations/{{taskId}}", "pathTemplate": { "$concat": [ { "$if": { "condition": { "$and": [ { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$ne": [ { "$ref": "media.role" }, "mask" ] } } } }, 0 ] }, { "$eq": [ { "$coalesce": [ { "$ref": "request.providerOptions.cangyuan-midjourney-v82.reference" }, { "$if": { "condition": { "$gt": [ { "$len": { "$filter": { "from": { "$ref": "request.images" }, "as": "media", "where": { "$eq": [ { "$ref": "media.role" }, "edit_source" ] } } } }, 0 ] }, "then": "editor", "else": "image" } } ] }, "editor" ] } ] }, "then": "/v1/images/edits", "else": "/v1/images/generations" } }, "/", { "$ref": "taskId" } ] } }, "response": { "taskIdPaths": [ "id", "task_id" ], "statusPaths": [ "status" ], "errorPaths": [ "error.code" ], "messagePaths": [ "error.message", "message" ], "images": { "$map": { "from": { "$ref": "response.data" }, "as": "item", "in": { "url": { "$ref": "item.url" } } } }, "usage": { "$ref": "response.usage" } } } ] }, "documentation": "# 沧元 Midjourney\n\n独立声明式协议插件（`yingce.plugin/v2`），同时提供 `cangyuan-midjourney-v7` 和 `cangyuan-midjourney-v82`。使用宿主的渠道鉴权、出站安全检查、下载和资源持久化，不执行额外服务代码。\n\nV7 使用 `midjourney-v7`，无分辨率和速度档。1K/2K 使用 `midjourney-1k` / `midjourney-2k`，供应商默认版本为 V8.2，提示词可显式写 `--v 8.2`；不存在独立的 `midjourney-v8.2` 模型名。\n\n两条线路不能互换。1K/2K 返回官网 CDN 原链，服务器下载可能遇到 HTTP 403；本插件不会伪报保存成功或自动换模型。V7 返回供应商可直接下载的结果地址。`n=1` 表示一次请求，返回的所有图片均交给宿主保存。\n\n完整接口见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# 沧元 Midjourney 接口字段\n\n## 来源与协议身份\n\n- V7：https://ai.cangyuansuanli.cn/docs/models/midjourney-v7\n- V8.2 / 1K / 2K：https://ai.cangyuansuanli.cn/docs/models/midjourney-1k\n- 模型清单以渠道 `GET /v1/models` 为准：`midjourney-v7`、`midjourney-1k`、`midjourney-2k`。\n- 插件 ID `cangyuan-midjourney`；Provider ID `cangyuan-midjourney-v7`、`cangyuan-midjourney-v82`。\n- 配置 `apiKey`（secret、必填），由宿主渠道配置提供；鉴权 `Authorization: Bearer `。\n- 创建 `POST /v1/images/generations`；源图编辑 `POST /v1/images/edits`。\n- 查询 `GET /v1/images/generations/{task_id}`；编辑查询 `GET /v1/images/edits/{task_id}`。\n- 默认同步等待（`async=false`）；保留任务 ID、查询路径以及 pending/completed/failed 的响应解析。\n- 不声明取消或单独结果下载端点，供应商未提供相应合同。\n\n## 统一参数与上游请求\n\n| 参数 | 映射与约束 |\n| --- | --- |\n| `model` | 两条线路分别校验公开模型名，不自动换模型。 |\n| `prompt` | 原样传递；V7 最多 4000 字符。1K/2K 可在提示词写 `--v 8.2`，省略版本时由供应商默认 V8.2。 |\n| `images` | 依据宿主 role 排序，映射为 HTTPS URL 字符串数组；不能发 data URI 或本地文件。V7 最多 5 张，拒绝蒙版。 |\n| `imageCount` | 只能为 1 或未设置，上游固定 `n=1`；返回多张不截断。 |\n| `aspectRatio` | 传 `size`；空值或 auto 不发送。V7 支持 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 5:4 / 4:5 / 21:9 及对应宽x高；默认 16:9。1K/2K 支持 1:2 / 6:11 / 9:16 / 2:3 / 3:4 / 4:5 / 5:6 / 1:1 及其反向比例。 |\n| `providerOptions` | 仅 1K/2K 使用 `cangyuan-midjourney-v82.speed`（relax / fast）和 `reference`（image / style / edit / moodboard / editor）。不把速度映射为 quality。 |\n\n`reference=editor` 或宿主显式 `edit_source` 默认走 edits，必须只有一张源图；`reference=edit` 走 generations，最多四张图。mask role 单独映射为 `mask` HTTPS URL，仅 editor 可用。style/moodboard 等含义由调用方显式指定，插件不猜测风格用途。speed 不指定时不发送，沿用供应商默认或 prompt 中的 --fast/--relax；两者同时指定时须一致。\n\nV7 不支持 --v、--niji、--fast、--hd，且不发送 speed、quality、resolution、background、output_format、mask。1K/2K 不发送 quality、resolution、aspect_ratio、background、output_format，不支持 b64_json；不要写 --turbo，1K 不写 --hd。\n\n两条线路均固定 `response_format=url`、`async=false`。请求完整字段、校验表达式与动态端点见下方 Manifest，未列出的字段不透传。\n\n## 响应、保存和错误\n\n- 创建或查询任务 ID：`id` / `task_id`；查询保留当前 task ID。\n- 状态读取 `status`，queued/pending 为等待，processing/running 为进行中，completed/succeeded 为完成，failed 为失败。\n- 同步 `data[].url` 无 status 时，宿主依据真实图片引用判定完成；遍历全部 data 元素。\n- 错误读取 `error.code` 和 `error.message` / `message`；空结果仍失败，不伪造媒体。\n- 用量读取 `usage`，不在插件自行计算积分。\n- 所有 URL 通过现有宿主 SSRF、跨域凭证隔离、大小/MIME 校验和资源保存。跨源图片不携带供应商 API Key。\n- 1K/2K 官方 CDN HTTP 403 与协议字段映射是两件事；新增插件不能保证消除 CDN 拦截。失败保留原任务恢复机制，不提交新的收费生成。\n\n\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n \"apiVersion\": \"yingce.plugin/v2\",\n \"id\": \"cangyuan-midjourney\",\n \"name\": \"沧元 Midjourney\",\n \"version\": \"1.0.0\",\n \"author\": \"沧元算力 / 影绘\",\n \"description\": \"独立适配 V7 与默认 V8.2 的 1K/2K 线路，按供应商合同创建、查询并提取全部图片。\",\n \"enabled\": true,\n \"installable\": true,\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\": \"cangyuan-midjourney-v7\",\n \"label\": \"沧元 Midjourney V7\",\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://ai.cangyuansuanli.cn/v1\",\n \"requiresPublicMediaUrls\": true,\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\": \"供应商公开模型名；两条线路分别校验。\"\n },\n {\n \"name\": \"prompt\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"prompt\",\n \"description\": \"原提示词；1K/2K 默认 V8.2，可写官网 --v / --niji 参数；V7 不支持这些版本参数。\"\n },\n {\n \"name\": \"images\",\n \"type\": \"media[]\",\n \"mapping\": \"images[] / mask\",\n \"description\": \"按宿主显式 role 转换为 HTTPS URL 字符串数组；mask 单独映射。\"\n },\n {\n \"name\": \"imageCount\",\n \"type\": \"integer\",\n \"mapping\": \"n=1\",\n \"description\": \"一次提交只能为 1，结果 data 可能含多张，全部保存。\"\n },\n {\n \"name\": \"aspectRatio\",\n \"type\": \"string\",\n \"mapping\": \"size\",\n \"description\": \"比例或 V7 宽x高；空值和 auto 不发送，沿用供应商默认值。\"\n },\n {\n \"name\": \"providerOptions\",\n \"type\": \"object\",\n \"mapping\": \"cangyuan-midjourney-v82.speed/reference\",\n \"description\": \"1K/2K 插件命名空间可指定 speed=relax/fast、reference=image/style/edit/moodboard/editor。V7 没有速度或版本扩展字段。\"\n }\n ],\n \"validations\": [\n {\n \"assert\": {\n \"$in\": [\n {\n \"$ref\": \"request.model\"\n },\n [\n \"midjourney-v7\"\n ]\n ]\n },\n \"message\": \"模型名与 Midjourney 线路不匹配。\"\n },\n {\n \"assert\": {\n \"$lte\": [\n {\n \"$ref\": \"request.imageCount\"\n },\n 1\n ]\n },\n \"message\": \"Midjourney 一次提交 n 只能为 1；返回多张图片会全部保存。\"\n },\n {\n \"assert\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$trim\": {\n \"$ref\": \"request.prompt\"\n }\n }\n },\n 0\n ]\n },\n \"message\": \"Midjourney 提示词不能为空。\"\n },\n {\n \"assert\": {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$first\": {\n \"$split\": [\n {\n \"$ref\": \"media.value\"\n },\n \":\"\n ]\n }\n },\n \"https\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"message\": \"Midjourney 参考图和蒙版必须是 HTTPS URL，不能发送本地文件或 data URI。\"\n },\n {\n \"assert\": {\n \"$lte\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 5\n ]\n },\n \"message\": \"Midjourney V7 参考图最多 5 张。\"\n },\n {\n \"assert\": {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"message\": \"Midjourney V7 线路不支持蒙版。\"\n },\n {\n \"assert\": {\n \"$lte\": [\n {\n \"$len\": {\n \"$ref\": \"request.prompt\"\n }\n },\n 4000\n ]\n },\n \"message\": \"Midjourney V7 提示词最多 4000 字符。\"\n }\n ],\n \"create\": {\n \"method\": \"POST\",\n \"path\": \"/v1/images/generations\",\n \"contentType\": \"application/json\",\n \"body\": {\n \"model\": {\n \"$ref\": \"request.model\"\n },\n \"prompt\": {\n \"$ref\": \"request.prompt\"\n },\n \"n\": 1,\n \"size\": {\n \"$if\": {\n \"condition\": {\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 \"else\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"images\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": {\n \"$map\": {\n \"from\": {\n \"$sortByOrder\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n \"as\": \"media\",\n \"in\": {\n \"$ref\": \"media.value\"\n }\n }\n },\n \"else\": null\n }\n },\n \"response_format\": \"url\",\n \"async\": false\n },\n \"pathTemplate\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"/v1/images/edits\",\n \"else\": \"/v1/images/generations\"\n }\n }\n },\n \"poll\": {\n \"method\": \"GET\",\n \"path\": \"/v1/images/generations/{{taskId}}\",\n \"pathTemplate\": {\n \"$concat\": [\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"/v1/images/edits\",\n \"else\": \"/v1/images/generations\"\n }\n },\n \"/\",\n {\n \"$ref\": \"taskId\"\n }\n ]\n }\n },\n \"response\": {\n \"taskIdPaths\": [\n \"id\",\n \"task_id\"\n ],\n \"statusPaths\": [\n \"status\"\n ],\n \"errorPaths\": [\n \"error.code\"\n ],\n \"messagePaths\": [\n \"error.message\",\n \"message\"\n ],\n \"images\": {\n \"$map\": {\n \"from\": {\n \"$ref\": \"response.data\"\n },\n \"as\": \"item\",\n \"in\": {\n \"url\": {\n \"$ref\": \"item.url\"\n }\n }\n }\n },\n \"usage\": {\n \"$ref\": \"response.usage\"\n }\n }\n },\n {\n \"id\": \"cangyuan-midjourney-v82\",\n \"label\": \"沧元 Midjourney 1K/2K · V8.2\",\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://ai.cangyuansuanli.cn/v1\",\n \"requiresPublicMediaUrls\": true,\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\": \"供应商公开模型名；两条线路分别校验。\"\n },\n {\n \"name\": \"prompt\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"prompt\",\n \"description\": \"原提示词；1K/2K 默认 V8.2，可写官网 --v / --niji 参数；V7 不支持这些版本参数。\"\n },\n {\n \"name\": \"images\",\n \"type\": \"media[]\",\n \"mapping\": \"images[] / mask\",\n \"description\": \"按宿主显式 role 转换为 HTTPS URL 字符串数组；mask 单独映射。\"\n },\n {\n \"name\": \"imageCount\",\n \"type\": \"integer\",\n \"mapping\": \"n=1\",\n \"description\": \"一次提交只能为 1，结果 data 可能含多张，全部保存。\"\n },\n {\n \"name\": \"aspectRatio\",\n \"type\": \"string\",\n \"mapping\": \"size\",\n \"description\": \"比例或 V7 宽x高；空值和 auto 不发送，沿用供应商默认值。\"\n },\n {\n \"name\": \"providerOptions\",\n \"type\": \"object\",\n \"mapping\": \"cangyuan-midjourney-v82.speed/reference\",\n \"description\": \"1K/2K 插件命名空间可指定 speed=relax/fast、reference=image/style/edit/moodboard/editor。V7 没有速度或版本扩展字段。\"\n }\n ],\n \"validations\": [\n {\n \"assert\": {\n \"$in\": [\n {\n \"$ref\": \"request.model\"\n },\n [\n \"midjourney-1k\",\n \"midjourney-2k\"\n ]\n ]\n },\n \"message\": \"模型名与 Midjourney 线路不匹配。\"\n },\n {\n \"assert\": {\n \"$lte\": [\n {\n \"$ref\": \"request.imageCount\"\n },\n 1\n ]\n },\n \"message\": \"Midjourney 一次提交 n 只能为 1；返回多张图片会全部保存。\"\n },\n {\n \"assert\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$trim\": {\n \"$ref\": \"request.prompt\"\n }\n }\n },\n 0\n ]\n },\n \"message\": \"Midjourney 提示词不能为空。\"\n },\n {\n \"assert\": {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$first\": {\n \"$split\": [\n {\n \"$ref\": \"media.value\"\n },\n \":\"\n ]\n }\n },\n \"https\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"message\": \"Midjourney 参考图和蒙版必须是 HTTPS URL，不能发送本地文件或 data URI。\"\n },\n {\n \"assert\": {\n \"$in\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.speed\"\n },\n \"relax\"\n ]\n },\n [\n \"relax\",\n \"fast\"\n ]\n ]\n },\n \"message\": \"Midjourney speed 只支持 relax 或 fast。\"\n },\n {\n \"assert\": {\n \"$in\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n [\n \"image\",\n \"style\",\n \"edit\",\n \"moodboard\",\n \"editor\"\n ]\n ]\n },\n \"message\": \"Midjourney reference 类型无效。\"\n },\n {\n \"assert\": {\n \"$or\": [\n {\n \"$not\": {\n \"$eq\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"editor\"\n ]\n }\n },\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 1\n ]\n }\n ]\n },\n \"message\": \"Midjourney editor 只能有一张源图。\"\n },\n {\n \"assert\": {\n \"$or\": [\n {\n \"$ne\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"edit\"\n ]\n },\n {\n \"$lte\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 4\n ]\n }\n ]\n },\n \"message\": \"Midjourney edit 参考图最多 4 张。\"\n },\n {\n \"assert\": {\n \"$lte\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 1\n ]\n },\n \"message\": \"Midjourney 蒙版只能有一张。\"\n },\n {\n \"assert\": {\n \"$or\": [\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n {\n \"$and\": [\n {\n \"$eq\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"editor\"\n ]\n },\n {\n \"$eq\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 1\n ]\n }\n ]\n }\n ]\n },\n \"message\": \"蒙版只能用于 editor，且必须有一张源图。\"\n }\n ],\n \"create\": {\n \"method\": \"POST\",\n \"path\": \"/v1/images/generations\",\n \"contentType\": \"application/json\",\n \"body\": {\n \"model\": {\n \"$ref\": \"request.model\"\n },\n \"prompt\": {\n \"$ref\": \"request.prompt\"\n },\n \"n\": 1,\n \"size\": {\n \"$if\": {\n \"condition\": {\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 \"else\": {\n \"$ref\": \"request.aspectRatio\"\n }\n }\n },\n \"images\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": {\n \"$map\": {\n \"from\": {\n \"$sortByOrder\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n \"as\": \"media\",\n \"in\": {\n \"$ref\": \"media.value\"\n }\n }\n },\n \"else\": null\n }\n },\n \"response_format\": \"url\",\n \"async\": false,\n \"speed\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.speed\"\n }\n },\n \"reference\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"else\": null\n }\n },\n \"mask\": {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": {\n \"$first\": {\n \"$map\": {\n \"from\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n },\n \"as\": \"media\",\n \"in\": {\n \"$ref\": \"media.value\"\n }\n }\n }\n },\n \"else\": null\n }\n }\n },\n \"pathTemplate\": {\n \"$if\": {\n \"condition\": {\n \"$and\": [\n {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n {\n \"$eq\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"editor\"\n ]\n }\n ]\n },\n \"then\": \"/v1/images/edits\",\n \"else\": \"/v1/images/generations\"\n }\n }\n },\n \"poll\": {\n \"method\": \"GET\",\n \"path\": \"/v1/images/generations/{{taskId}}\",\n \"pathTemplate\": {\n \"$concat\": [\n {\n \"$if\": {\n \"condition\": {\n \"$and\": [\n {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$ne\": [\n {\n \"$ref\": \"media.role\"\n },\n \"mask\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n {\n \"$eq\": [\n {\n \"$coalesce\": [\n {\n \"$ref\": \"request.providerOptions.cangyuan-midjourney-v82.reference\"\n },\n {\n \"$if\": {\n \"condition\": {\n \"$gt\": [\n {\n \"$len\": {\n \"$filter\": {\n \"from\": {\n \"$ref\": \"request.images\"\n },\n \"as\": \"media\",\n \"where\": {\n \"$eq\": [\n {\n \"$ref\": \"media.role\"\n },\n \"edit_source\"\n ]\n }\n }\n }\n },\n 0\n ]\n },\n \"then\": \"editor\",\n \"else\": \"image\"\n }\n }\n ]\n },\n \"editor\"\n ]\n }\n ]\n },\n \"then\": \"/v1/images/edits\",\n \"else\": \"/v1/images/generations\"\n }\n },\n \"/\",\n {\n \"$ref\": \"taskId\"\n }\n ]\n }\n },\n \"response\": {\n \"taskIdPaths\": [\n \"id\",\n \"task_id\"\n ],\n \"statusPaths\": [\n \"status\"\n ],\n \"errorPaths\": [\n \"error.code\"\n ],\n \"messagePaths\": [\n \"error.message\",\n \"message\"\n ],\n \"images\": {\n \"$map\": {\n \"from\": {\n \"$ref\": \"response.data\"\n },\n \"as\": \"item\",\n \"in\": {\n \"url\": {\n \"$ref\": \"item.url\"\n }\n }\n }\n },\n \"usage\": {\n \"$ref\": \"response.usage\"\n }\n }\n }\n ]\n },\n \"documentation\": \"<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>\"\n}\n```\n\n" }