可灵 AI
只使用本包在 https://klingai.com/mcp 配置的可灵 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。
- Before OAuth dynamic client registration, include
client_name: "Plugin-WorkBuddy". This is OAuth metadata, not a tool argument, URL parameter, or secret. If WorkBuddy cannot inject it, stop before authorization and report the limitation. - 用户提出单项生成请求,即表示在补齐会实质影响结果的缺失信息后,授权该收费生成步骤提交一次。跨媒体请求或用户明确要求多个不同任务时,把用户已明确要求的每个收费步骤分别视为一次授权;未明确要求的额外步骤必须先询问。不要额外增加灵感值消耗警告或单独确认步骤。
- 每个明确授权的收费生成步骤最多提交一次。失败或结果不明确时,不要自动重试。
- 运行时发现远程工具和模式定义;提供方的实时模式定义优先于本 Skill 的示例。
- 提交进入非终态后,按提供方允许的间隔查询状态,直到成功或失败。只有用户取消或当前轮次超时才停止;停止时返回当前状态和任务编号。
引用按请求类型加载:单一图片或视频生成交给对应专业 Skill,不在本 Skill 重复读取;跨媒体请求只先读取工具流程,每个收费阶段再由对应专业 Skill 读取MCP 输入输出契约、模型参数快照和失败预防门禁;账号、额度和状态查询只使用实时工具说明,Element 操作才读取 MCP 契约。只有出现授权、模式定义、素材接入或提供方错误时,才读取故障排查。
工作流程
- 判断用户需要生成、动作控制、Element 管理、账号操作还是只读查询。跨媒体生成先拆成用户已明确要求的图片与视频收费步骤,并分别采用对应专业 Skill 的工作流。
- 先读取当前连接的
tools/list;生成或动作控制前再调用who_am_i,从目标模型声明中获取完整参数与素材输入。若mcpVersion高于本包快照1.3.1,不要仅因版本号较高反复阻断:当前工具列表与实时模型 schema 能完整描述目标调用时,以实时结果为准继续;只有目标工具缺失、顶层 schema 与实时模型要求冲突或宿主明确提示工具列表过期时,才要求重启宿主并在新会话刷新连接器。紧邻每次收费生成前调用query_membership_and_credits;明确无余额或不足时停止。 - 按所选模型的实时 schema 处理图片输入,优先使用宿主已提供且 schema 接受的图片引用。只要素材来自较早的 Kling 结果,就忽略会话里保存的旧 URL,在提交新任务前用绑定的
generationId调用一次query_tasks,按已保存的works[]序号与contentType取回当前 URL,并在同一轮立即使用。 - 只询问会实质影响结果的缺失创意要求,并只补齐会实质改变结果的缺失设置。
- 选定工具和模型后再构造请求。把该模型实时
arguments[]和inputs[]建立为封闭白名单;逐项校验model、默认值、必填项、枚举、数量限制和 input 名称。未声明字段一律不传;切换模型后必须从空请求重新构造。 - 每个明确授权的收费步骤选定远程生成工具后只调用一次。同一用户目标同一时间最多保留一个未终态收费任务;多个不同任务必须逐个等待终态。
who_am_i、额度查询和附件解析都是准备步骤;用户已要求生成且输入完整、余额未显示不足时,不要在准备步骤后结束。 - 完整保留提供方返回的
generationId和taskTraceId。结果包含多个works[]时,还要把每个展示作品与其数组序号、contentType绑定;稳定标识是任务编号和作品序号,不是结果 URL。同一目标链路复用 UUIDv7taskTraceId;向用户把generationId显示为任务编号。 - 提交未进入终态时,持续查询到成功或失败。若用户取消或当前轮次超时,返回当前状态和任务编号。
- 返回远程工具提供的主图、视频、文本或主要结果链接,并说明结果 URL 有效期为 24 小时;需要长期保留时应及时下载。
- 用户直接查询状态时,只调用一次实时状态工具并返回当前状态,不启动长时间轮询。
- 删除 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 并停止;反馈不构成重试或修复。