Kling Ai Plugin

---
name: kling-ai-plugin
description: 当用户希望通过 WorkBuddy 中的 Kling AI 连接器生成影视级、专业级图像或视频时使用。将自然语言需求路由为适配文生图、图生图、文生视频或图生视频的精确提示词，适合海报、广告、产品视觉和短片等创作场景；也用于主体库（Element）的创建、查看、更新、删除与复用，动作库查询、动作控制、素材上传、账号额度和任务查询。
---

# 可灵 AI

只使用本包在 `https://klingai.com/mcp/plugin` 配置的可灵 MCP 服务。

## 请求路由

- 文生图、图生图、海报、封面、产品静物和图像概念请求交给 `kling-ai-generate-image`。
- 文生视频、图生视频、动作控制、动画、镜头运动、分镜和视频概念请求交给 `kling-ai-generate-video`。
- OAuth、退出或切换账号、附件输入、动作库、Element 素材库、灵感值查询和任务状态查询保留在本 Skill 中处理。跨媒体请求由本 Skill 编排：图片阶段采用 `kling-ai-generate-image` 的提示词与提交规则，视频阶段采用 `kling-ai-generate-video` 的动态与镜头规则；各收费步骤严格串行。
- 对已有结果的纯状态查询、重新获取链接或下载请求走结果查询流程，不创建生成任务。基于已有结果继续编辑、生成变体或制作视频属于新的收费生成步骤：先按任务编号刷新并选定目标作品，再按对应专业 Skill 提交一次新任务。

附件本身不能决定用途，但也不要机械追问角色。用户说“用这张图做视频”“编辑这张图”等且用途只能合理对应首帧或待编辑源图时，直接采用该角色；只有首帧、身份或产品参考、待编辑源图、风格参考之间存在多个会实质改变结果的合理解释时才询问。

生成请求包含图片时，先选择工具和模型，再按该模型当次声明的精确 input 名称映射素材。`image_1`、`first_image` 和 `image` 属于不同模型或工具，不能互换。

## 安全与提交约定

- 只使用宿主的 MCP OAuth 连接流程。绝不索取 API Key，也不在日志中暴露凭证、Cookie、授权头、私有账号字段或签名 URL。
- 用户提出单项生成请求，即表示在补齐会实质影响结果的缺失信息后，授权该收费生成步骤提交一次。跨媒体请求或用户明确要求多个不同任务时，把用户已明确要求的每个收费步骤分别视为一次授权；未明确要求的额外步骤必须先询问。不要额外增加灵感值消耗警告或单独确认步骤。
- 每个明确授权的收费生成步骤最多提交一次。失败或结果不明确时，不要自动重试。
- 运行时发现远程工具和模式定义；提供方的实时模式定义优先于本 Skill 的示例。
- 提交进入非终态后，按提供方允许的间隔查询状态，直到成功或失败。只有用户取消或当前轮次超时才停止；停止时返回当前状态和任务编号。

引用按请求类型加载：单一图片或视频生成交给对应专业 Skill，不在本 Skill 重复读取；跨媒体请求只先读取[工具流程](references/tool-workflows.md)，每个收费阶段再由对应专业 Skill 读取[MCP 输入输出契约](references/mcp-contract.md)、[模型参数快照](references/model-parameters.md)和[失败预防门禁](references/failure-prevention.md)；账号、额度和状态查询只使用实时工具说明；主体库、动作库和本地素材上传读取[素材工作流](references/asset-workflows.md)与 MCP 契约。只有出现授权、模式定义、素材接入或提供方错误时，才读取[故障排查](references/troubleshooting.md)。

## 工作流程

1. 判断用户需要生成、动作控制、主体库（Element）管理、动作库查询、素材上传、账号操作还是只读查询。独立素材操作走素材工作流，完成后直接返回；下方选模型、查余额、提交及轮询仅适用于生成。跨媒体生成先拆成用户已明确要求的图片与视频收费步骤，并分别采用对应专业 Skill 的工作流。
2. 先读取当前连接的 `tools/list`；生成或动作控制前再调用 `who_am_i`，从目标模型声明中获取完整参数与素材输入。若 `mcpVersion` 高于本包快照 `1.3.1`，不要仅因版本号较高反复阻断：当前工具列表与实时模型 schema 能完整描述目标调用时，以实时结果为准继续；只有目标工具缺失、顶层 schema 与实时模型要求冲突或宿主明确提示工具列表过期时，才要求重启宿主并在新会话刷新连接器。紧邻每次收费生成前调用 `query_membership_and_credits`；明确无余额或不足时停止。
3. 按所选模型的实时 schema 处理图片输入，优先使用宿主已提供且 schema 接受的图片引用；本地文件尚无可用引用时，按素材工作流检查 `file_upload` 两步上传能力。只要素材来自较早的 Kling 结果，就忽略会话里保存的旧 URL，在提交新任务前用绑定的 `generationId` 调用一次 `query_tasks`，按已保存的 `works[]` 序号与 `contentType` 取回当前 URL，并在同一轮立即使用。
4. 只询问会实质影响结果的缺失创意要求，并只补齐会实质改变结果的缺失设置。
5. 选定工具和模型后再构造请求。把该模型实时 `arguments[]` 和 `inputs[]` 建立为封闭白名单；逐项校验 `model`、默认值、必填项、枚举、数量限制和 input 名称。未声明字段一律不传；切换模型后必须从空请求重新构造。
6. 每个明确授权的收费步骤选定远程生成工具后只调用一次。同一用户目标同一时间最多保留一个未终态收费任务；多个不同任务必须逐个等待终态。`who_am_i`、额度查询和附件解析都是准备步骤；用户已要求生成且输入完整、余额未显示不足时，不要在准备步骤后结束。
7. 完整保留提供方返回的 `generationId` 和 `taskTraceId`。结果包含多个 `works[]` 时，还要把每个展示作品与其数组序号、`contentType` 绑定；稳定标识是任务编号和作品序号，不是结果 URL。同一目标链路复用 UUIDv7 `taskTraceId`；向用户把 `generationId` 显示为**任务编号**。
8. 提交未进入终态时，持续查询到成功或失败。若用户取消或当前轮次超时，返回当前状态和任务编号。
9. 返回远程工具提供的主图、视频、文本或主要结果链接，并说明结果 URL 有效期为 24 小时；需要长期保留时应及时下载。
10. 用户直接查询状态时，只调用一次实时状态工具并返回当前状态，不启动长时间轮询。
11. 删除 Element 或退出/切换账号属于状态变更；只有用户明确要求时调用，并遵守工具说明中的确认与重新授权流程。

## 质量与成本默认策略

专业成片标准首先由提示词、场面设计和连续性保证，不等同于自动选择最高成本模型或分辨率。仅在用户未指定其他选择且实时模式定义支持时使用以下规则：

- 模型：顶层 `model` 没有可省略的通用默认值。先满足生成模式、参考素材和必需能力，再按当次 `who_am_i` 的模型描述选择最匹配者；描述明确标注当前模式默认或首选时，在用户未指定模型时采用它。不要发明“平衡档”等 schema 未声明的档位，模型名称始终使用规范值。
- 图像：默认保留所选模型声明的分辨率，不自动升档。只有用户明确要求大幅输出、后期裁切、精细材质或 `4k` 时才提高；草稿、预览或省灵感值时才降低。不得静默降低用户明确要求的分辨率。
- 视频：默认保留所选模型声明的分辨率，不自动从 `720p` 升到 `1080p/4k`。只有用户明确要求正式成片、大屏、后期或指定分辨率时才提高；预览、快速或成本优先时才降低。不得静默降低用户明确要求的分辨率。
- 视频时长：一个动作或单一镜头用 `5` 秒；对白、演唱、完整产品动作或两个相连节拍优先 `10` 秒；复杂叙事只在实时模式支持且确有必要时使用更长时长。选择能完整表达内容的最短时长，不要把所有请求强行压成 5 秒。
- 文生视频宽高比：从投放位置推导；竖版短视频用 `9:16`，方形信息流用 `1:1`，横版广告、网页或 YouTube 用 `16:9`。没有投放上下文时才使用 `16:9`。
- 图生视频宽高比：根据首帧与投放位置推导。所选模型声明 `aspect_ratio` 时，只传其实时允许值；尤其不要因该字段可选而省略并误用模型默认画幅。所选模型没有声明该字段时必须省略。

## 失败处理

- 授权失败：引导用户使用 WorkBuddy 的原生 MCP 连接流程；授权成功后才重试。
- 模型或参数无效：刷新实时模式定义，只修改不受支持的字段。
- 资源不存在：若输入来自历史 Kling 结果，确认是否已执行提交前刷新。没有任务编号、作品序号丢失、查询失败、作品已不可用，或使用本轮新查询 URL 仍失败时，请用户重新提供图片；不要再次查询或复用任何旧 URL。
- 限流：报告提供方消息并停止，不等待后自动重试，也不改参数重新提交。
- 提供方任务失败：解释提供方消息并保留 `generationId`；不要重新提交。
- 灵感值不足：告知用户充值后停止。在用户明确表示余额已变化前，不得提交同一或其他收费生成请求。
- 提交响应丢失或超时：将任务是否创建视为未知。已取得 `generationId` 时只查询该任务；没有 `generationId` 时无法查询，报告状态未知并停止。只有用户明确授权承担可能重复扣费的风险后，才把后续生成视为新的收费步骤。
- 不透明、空结果、重复校验失败、计费异常或明确非预期结果：按工具说明调用一次 `feedback`，保留相关 ID 并停止；反馈不构成重试或修复。