tt/ttstd-infinite-canvas
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(plugin): 本地定制插件包更新（a6api/metaso-h3/antigravity-proxy/openai-images 渠道适配）

Browse Source
This commit is contained in:
Codex committed 2026-09-18 20:44:27 +08:00
1 parent 6ee9d1dcb2
commit e2b4b507cf
13 files changed
+2235 -289
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

plugin-packages/src-metaso-h3/docs/interface.md
+376
View File
@@ -59,3 +59,379 @@ status 取值：queued / running / succeeded / failed / cancelled。
## 错误
创建与查询均返回 OpenAI 风格错误体，含 `error.type` / `error.message` / `request_id`；余额不足为 402，速率限制为 429。
<!-- YINGCE_MANIFEST_CONTRACT_START -->
## Manifest 完整接口定义
以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。
```json
{
"apiVersion": "yingce.plugin/v2",
"id": "metaso-h3",
"name": "METASO MiniMax H3",
"version": "1.0.0",
"author": "METASO",
"description": "秘塔 METASO MiniMax H3 文生视频/图生视频协议插件（异步任务）。",
"permissions": [
"generation.run",
"media.read"
],
"configuration": {
"fields": [
{
"name": "apiKey",
"type": "secret",
"label": "API Key",
"required": true
}
]
},
"contributes": {
"providers": [
{
"id": "metaso-h3",
"label": "METASO MiniMax H3",
"capabilities": [
"video"
],
"scopes": [
"admin.system-channel",
"user.custom-channel",
"canvas",
"creation",
"agent"
],
"baseUrl": "https://metaso.cn",
"auth": {
"type": "bearer",
"field": "apiKey"
},
"requiresPublicMediaUrls": true,
"parameters": [
{
"name": "model",
"type": "string",
"required": true,
"mapping": "model",
"description": "视频模型 ID（MiniMax-H3 / MiniMax-H3-Max）。"
},
{
"name": "prompt",
"type": "string",
"required": true,
"mapping": "prompt/content/input",
"description": "视频提示词。"
},
{
"name": "images",
"type": "media[]",
"required": false,
"mapping": "first/last/reference image",
"description": "显式 role 图片输入（首帧/尾帧/参考图）。"
},
{
"name": "videos",
"type": "media[]",
"required": false,
"mapping": "reference video",
"description": "参考视频。"
},
{
"name": "audios",
"type": "media[]",
"required": false,
"mapping": "reference audio/voice",
"description": "参考音频或音色。"
},
{
"name": "duration",
"type": "integer",
"required": false,
"mapping": "duration/seconds",
"description": "时长秒数（4-15）。"
},
{
"name": "aspectRatio",
"type": "string",
"required": false,
"mapping": "ratio/aspect_ratio/size",
"description": "画幅比例（16:9 等）。"
},
{
"name": "resolution",
"type": "string",
"required": false,
"mapping": "resolution",
"description": "分辨率档位（768P / 2K）。"
},
{
"name": "watermark",
"type": "boolean",
"required": false,
"mapping": "watermark",
"description": "AIGC 水印开关。"
},
{
"name": "providerOptions",
"type": "object",
"required": false,
"mapping": "provider-specific fields",
"description": "插件命名空间内的厂商扩展字段。"
}
],
"create": {
"method": "POST",
"path": "/api/minimax/v2/video_generation",
"contentType": "application/json",
"body": {
"model": {
"$coalesce": [
{
"$ref": "request.model"
},
"MiniMax-H3"
]
},
"content": {
"$concatArrays": [
{
"$if": {
"condition": {
"$gt": [
{
"$len": {
"$ref": "request.prompt"
}
},
0
]
},
"then": [
{
"type": "text",
"text": {
"$ref": "request.prompt"
}
}
],
"else": []
}
},
{
"$map": {
"from": {
"$ref": "request.images"
},
"as": "media",
"in": {
"type": "image_url",
"image_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
},
{
"$map": {
"from": {
"$ref": "request.videos"
},
"as": "media",
"in": {
"type": "video_url",
"video_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
},
{
"$map": {
"from": {
"$ref": "request.audios"
},
"as": "media",
"in": {
"type": "audio_url",
"audio_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
}
]
},
"resolution": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.resolution"
},
{
"$ref": "request.providerOptions.metaso-h3.resolution"
},
"768P"
]
}
},
"duration": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.duration"
},
{
"$ref": "request.providerOptions.metaso-h3.duration"
},
5
]
}
},
"ratio": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.aspectRatio"
},
{
"$ref": "request.providerOptions.metaso-h3.ratio"
},
"16:9"
]
}
},
"aigc_watermark": {
"$omitEmpty": {
"$ref": "request.providerOptions.metaso-h3.aigc_watermark"
}
}
}
},
"poll": {
"method": "GET",
"path": "/api/minimax/v2/query/video_generation/{{taskId}}"
},
"response": {
"taskId": {
"$coalesce": [
{
"$ref": "response.task_id"
},
{
"$ref": "response.taskId"
},
{
"$ref": "response.data.task_id"
}
]
},
"status": {
"$coalesce": [
{
"$ref": "response.task.status"
},
{
"$ref": "response.status"
},
{
"$ref": "response.data.status"
},
"pending"
]
},
"message": {
"$coalesce": [
{
"$ref": "response.task.error.message"
},
{
"$ref": "response.task.fail_reason"
},
{
"$ref": "response.error.message"
},
{
"$ref": "response.message"
}
]
},
"videos": {
"$coalesce": [
{
"$ref": "response.task.content.url"
},
{
"$ref": "response.task.content.video_url"
},
{
"$ref": "response.content.url"
},
{
"$ref": "response.data.url"
}
]
},
"usage": {
"$ref": "response.task.usage"
},
"errorPaths": [
"task.error.type",
"error.type",
"error.code"
],
"resultEphemeral": true,
"messagePaths": [
"task.error.message",
"error.message"
]
}
}
]
},
"documentation": "<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>"
}
```
<!-- YINGCE_MANIFEST_CONTRACT_END -->
plugin-packages/src-metaso-h3/manifest.json
+311 -44
View File
@@ -5,10 +5,18 @@
"version": "1.0.0",
"author": "METASO",
"description": "秘塔 METASO MiniMax H3 文生视频/图生视频协议插件（异步任务）。",
"permissions": ["generation.run", "media.read"],
"permissions": [
"generation.run",
"media.read"
],
"configuration": {
"fields": [
{ "name": "apiKey", "type": "secret", "label": "API Key", "required": true }
{
"name": "apiKey",
"type": "secret",
"label": "API Key",
"required": true
}
]
},
"contributes": {
@@ -16,41 +24,262 @@
{
"id": "metaso-h3",
"label": "METASO MiniMax H3",
"capabilities": ["video"],
"scopes": ["admin.system-channel", "user.custom-channel", "canvas", "creation", "agent"],
"capabilities": [
"video"
],
"scopes": [
"admin.system-channel",
"user.custom-channel",
"canvas",
"creation",
"agent"
],
"baseUrl": "https://metaso.cn",
"auth": { "type": "bearer", "field": "apiKey" },
"auth": {
"type": "bearer",
"field": "apiKey"
},
"requiresPublicMediaUrls": true,
"parameters": [
{ "name": "model", "type": "string", "required": true, "mapping": "model", "description": "视频模型 ID（MiniMax-H3 / MiniMax-H3-Max）。" },
{ "name": "prompt", "type": "string", "required": true, "mapping": "prompt/content/input", "description": "视频提示词。" },
{ "name": "images", "type": "media[]", "required": false, "mapping": "first/last/reference image", "description": "显式 role 图片输入（首帧/尾帧/参考图）。" },
{ "name": "videos", "type": "media[]", "required": false, "mapping": "reference video", "description": "参考视频。" },
{ "name": "audios", "type": "media[]", "required": false, "mapping": "reference audio/voice", "description": "参考音频或音色。" },
{ "name": "duration", "type": "integer", "required": false, "mapping": "duration/seconds", "description": "时长秒数（4-15）。" },
{ "name": "aspectRatio", "type": "string", "required": false, "mapping": "ratio/aspect_ratio/size", "description": "画幅比例（16:9 等）。" },
{ "name": "resolution", "type": "string", "required": false, "mapping": "resolution", "description": "分辨率档位（768P / 2K）。" },
{ "name": "watermark", "type": "boolean", "required": false, "mapping": "watermark", "description": "AIGC 水印开关。" },
{ "name": "providerOptions", "type": "object", "required": false, "mapping": "provider-specific fields", "description": "插件命名空间内的厂商扩展字段。" }
{
"name": "model",
"type": "string",
"required": true,
"mapping": "model",
"description": "视频模型 ID（MiniMax-H3 / MiniMax-H3-Max）。"
},
{
"name": "prompt",
"type": "string",
"required": true,
"mapping": "prompt/content/input",
"description": "视频提示词。"
},
{
"name": "images",
"type": "media[]",
"required": false,
"mapping": "first/last/reference image",
"description": "显式 role 图片输入（首帧/尾帧/参考图）。"
},
{
"name": "videos",
"type": "media[]",
"required": false,
"mapping": "reference video",
"description": "参考视频。"
},
{
"name": "audios",
"type": "media[]",
"required": false,
"mapping": "reference audio/voice",
"description": "参考音频或音色。"
},
{
"name": "duration",
"type": "integer",
"required": false,
"mapping": "duration/seconds",
"description": "时长秒数（4-15）。"
},
{
"name": "aspectRatio",
"type": "string",
"required": false,
"mapping": "ratio/aspect_ratio/size",
"description": "画幅比例（16:9 等）。"
},
{
"name": "resolution",
"type": "string",
"required": false,
"mapping": "resolution",
"description": "分辨率档位（768P / 2K）。"
},
{
"name": "watermark",
"type": "boolean",
"required": false,
"mapping": "watermark",
"description": "AIGC 水印开关。"
},
{
"name": "providerOptions",
"type": "object",
"required": false,
"mapping": "provider-specific fields",
"description": "插件命名空间内的厂商扩展字段。"
}
],
"create": {
"method": "POST",
"path": "/api/minimax/v2/video_generation",
"contentType": "application/json",
"body": {
"model": { "$coalesce": [ { "$ref": "request.model" }, "MiniMax-H3" ] },
"content": {
"$concatArrays": [
{ "$if": { "condition": { "$gt": [ { "$len": { "$ref": "request.prompt" } }, 0 ] }, "then": [ { "type": "text", "text": { "$ref": "request.prompt" } } ], "else": [] } },
{ "$map": { "from": { "$ref": "request.images" }, "as": "media", "in": { "type": "image_url", "image_url": { "url": { "$coalesce": [ { "$ref": "media.url" }, { "$ref": "media.dataUrl" } ] } }, "role": { "$omitEmpty": { "$ref": "media.role" } } } } },
{ "$map": { "from": { "$ref": "request.videos" }, "as": "media", "in": { "type": "video_url", "video_url": { "url": { "$coalesce": [ { "$ref": "media.url" }, { "$ref": "media.dataUrl" } ] } }, "role": { "$omitEmpty": { "$ref": "media.role" } } } } },
{ "$map": { "from": { "$ref": "request.audios" }, "as": "media", "in": { "type": "audio_url", "audio_url": { "url": { "$coalesce": [ { "$ref": "media.url" }, { "$ref": "media.dataUrl" } ] } }, "role": { "$omitEmpty": { "$ref": "media.role" } } } } }
"model": {
"$coalesce": [
{
"$ref": "request.model"
},
"MiniMax-H3"
]
},
"resolution": { "$omitEmpty": { "$coalesce": [ { "$ref": "request.resolution" }, { "$ref": "request.providerOptions.metaso-h3.resolution" }, "768P" ] } },
"duration": { "$omitEmpty": { "$coalesce": [ { "$ref": "request.duration" }, { "$ref": "request.providerOptions.metaso-h3.duration" }, 5 ] } },
"ratio": { "$omitEmpty": { "$coalesce": [ { "$ref": "request.aspectRatio" }, { "$ref": "request.providerOptions.metaso-h3.ratio" }, "16:9" ] } },
"aigc_watermark": { "$omitEmpty": { "$ref": "request.providerOptions.metaso-h3.aigc_watermark" } }
"content": {
"$concatArrays": [
{
"$if": {
"condition": {
"$gt": [
{
"$len": {
"$ref": "request.prompt"
}
},
0
]
},
"then": [
{
"type": "text",
"text": {
"$ref": "request.prompt"
}
}
],
"else": []
}
},
{
"$map": {
"from": {
"$ref": "request.images"
},
"as": "media",
"in": {
"type": "image_url",
"image_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
},
{
"$map": {
"from": {
"$ref": "request.videos"
},
"as": "media",
"in": {
"type": "video_url",
"video_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
},
{
"$map": {
"from": {
"$ref": "request.audios"
},
"as": "media",
"in": {
"type": "audio_url",
"audio_url": {
"url": {
"$coalesce": [
{
"$ref": "media.url"
},
{
"$ref": "media.dataUrl"
}
]
}
},
"role": {
"$omitEmpty": {
"$ref": "media.role"
}
}
}
}
}
]
},
"resolution": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.resolution"
},
{
"$ref": "request.providerOptions.metaso-h3.resolution"
},
"768P"
]
}
},
"duration": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.duration"
},
{
"$ref": "request.providerOptions.metaso-h3.duration"
},
5
]
}
},
"ratio": {
"$omitEmpty": {
"$coalesce": [
{
"$ref": "request.aspectRatio"
},
{
"$ref": "request.providerOptions.metaso-h3.ratio"
},
"16:9"
]
}
},
"aigc_watermark": {
"$omitEmpty": {
"$ref": "request.providerOptions.metaso-h3.aigc_watermark"
}
}
}
},
"poll": {
@@ -60,41 +289,79 @@
"response": {
"taskId": {
"$coalesce": [
{ "$ref": "response.task_id" },
{ "$ref": "response.taskId" },
{ "$ref": "response.data.task_id" }
{
"$ref": "response.task_id"
},
{
"$ref": "response.taskId"
},
{
"$ref": "response.data.task_id"
}
]
},
"status": {
"$coalesce": [
{ "$ref": "response.task.status" },
{ "$ref": "response.status" },
{ "$ref": "response.data.status" },
{
"$ref": "response.task.status"
},
{
"$ref": "response.status"
},
{
"$ref": "response.data.status"
},
"pending"
]
},
"message": {
"$coalesce": [
{ "$ref": "response.task.error.message" },
{ "$ref": "response.task.fail_reason" },
{ "$ref": "response.error.message" },
{ "$ref": "response.message" }
{
"$ref": "response.task.error.message"
},
{
"$ref": "response.task.fail_reason"
},
{
"$ref": "response.error.message"
},
{
"$ref": "response.message"
}
]
},
"videos": {
"$coalesce": [
{ "$ref": "response.task.content.url" },
{ "$ref": "response.task.content.video_url" },
{ "$ref": "response.content.url" },
{ "$ref": "response.data.url" }
{
"$ref": "response.task.content.url"
},
{
"$ref": "response.task.content.video_url"
},
{
"$ref": "response.content.url"
},
{
"$ref": "response.data.url"
}
]
},
"usage": { "$ref": "response.task.usage" },
"errorPaths": ["task.error.type", "error.type", "error.code"],
"usage": {
"$ref": "response.task.usage"
},
"errorPaths": [
"task.error.type",
"error.type",
"error.code"
],
"resultEphemeral": true,
"messagePaths": ["task.error.message", "error.message"]
"messagePaths": [
"task.error.message",
"error.message"
]
}
}
]
}
},
"documentation": "# METASO MiniMax H3\n\n秘塔 METASO MiniMax H3 文生视频 / 图生视频协议插件（异步任务模式）。\n\n## Provider\n\n| Provider | 能力 | 端点 |\n|---|---|---|\n| metaso-h3 | video | POST /api/minimax/v2/video_generation（创建）<br>GET /api/minimax/v2/query/video_generation/{taskId}（轮询） |\n\n## 配置\n\n在渠道中填写 API Key（METASO 控制台创建，形如 `mk-xxxxxxxx`），baseUrl 使用 `https://metaso.cn`。\n\n## 说明\n\n- 模型：`MiniMax-H3`（支持 768P / 2K，4-15 秒，文生图/图生视频/多模态参考），`MiniMax-H3-Max`（480P / 768P，5-15 秒）。\n- 文生视频：仅文本提示词，ratio 必填（21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16）。\n- 图生视频：图片 role 为 first_frame / last_frame（首尾帧）。\n- 多模态参考：图片 reference_image / 视频 reference_video / 音频 reference_audio。\n- 异步任务：创建后返回 task_id，轮询查询接口直到 status=succeeded，成片 URL 在 task.content.url。\n- 鉴权：`Authorization: Bearer mk-xxx`。\n\n---\n\n# METASO MiniMax H3 接口说明\n\n## 鉴权\n\n`Authorization: Bearer mk-xxxxxxxxxxxxxxxxxxxxxxxx`\n\n## 创建视频生成任务\n\nPOST `https://metaso.cn/api/minimax/v2/video_generation`\n\n请求体：\n\n```json\n{\n \"model\": \"MiniMax-H3\",\n \"content\": [\n { \"type\": \"text\", \"text\": \"视频描述\" },\n { \"type\": \"image_url\", \"image_url\": { \"url\": \"https://...\" }, \"role\": \"first_frame\" },\n { \"type\": \"video_url\", \"video_url\": { \"url\": \"https://...\" }, \"role\": \"reference_video\" },\n { \"type\": \"audio_url\", \"audio_url\": { \"url\": \"https://...\" }, \"role\": \"reference_audio\" }\n ],\n \"resolution\": \"768P\",\n \"duration\": 5,\n \"ratio\": \"16:9\"\n}\n```\n\n- content 必须包含一个非空 text 项。\n- 首尾帧（first_frame/last_frame）与多模态参考（reference_*）互斥。\n- 图片 ≤ 9 张、视频 ≤ 3 段、音频 ≤ 3 段；请求体总大小 ≤ 64 MB。\n\n响应：\n\n```json\n{ \"task_id\": \"424010985738629\" }\n```\n\n## 查询任务\n\nGET `https://metaso.cn/api/minimax/v2/query/video_generation/{task_id}`\n\n响应：\n\n```json\n{\n \"task\": {\n \"id\": \"424010985738629\",\n \"status\": \"succeeded\",\n \"content\": { \"url\": \"https://.../output.mp4\" },\n \"resolution\": \"2K\",\n \"duration\": 5,\n \"usage\": { \"total_seconds\": 5, \"output_seconds\": 5 }\n }\n}\n```\n\nstatus 取值：queued / running / succeeded / failed / cancelled。\n\n## 错误\n\n创建与查询均返回 OpenAI 风格错误体，含 `error.type` / `error.message` / `request_id`；余额不足为 402，速率限制为 429。\n\n<!-- YINGCE_MANIFEST_CONTRACT_START -->\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n \"apiVersion\": \"yingce.plugin/v2\",\n \"id\": \"metaso-h3\",\n \"name\": \"METASO MiniMax H3\",\n \"version\": \"1.0.0\",\n \"author\": \"METASO\",\n \"description\": \"秘塔 METASO MiniMax H3 文生视频/图生视频协议插件（异步任务）。\",\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\": \"metaso-h3\",\n \"label\": \"METASO MiniMax H3\",\n \"capabilities\": [\n \"video\"\n ],\n \"scopes\": [\n \"admin.system-channel\",\n \"user.custom-channel\",\n \"canvas\",\n \"creation\",\n \"agent\"\n ],\n \"baseUrl\": \"https://metaso.cn\",\n \"auth\": {\n \"type\": \"bearer\",\n \"field\": \"apiKey\"\n },\n \"requiresPublicMediaUrls\": true,\n \"parameters\": [\n {\n \"name\": \"model\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"model\",\n \"description\": \"视频模型 ID（MiniMax-H3 / MiniMax-H3-Max）。\"\n },\n {\n \"name\": \"prompt\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"prompt/content/input\",\n \"description\": \"视频提示词。\"\n },\n {\n \"name\": \"images\",\n \"type\": \"media[]\",\n \"required\": false,\n \"mapping\": \"first/last/reference image\",\n \"desLine truncated
}