n8n子流程：调Kie.ai生成视频并缓存到Google Drive

原文要点

原模板是一个n8n子流程，用来替代失效的Sora视频生成步骤：接收上游传入的提示词与可选渲染参数（时长、宽高比、分辨率、首帧、回调、模型链），做参数归一化与钳制并生成确定性任务键，先查n8n Data Table缓存，命中即返回旧结果；未命中按模型备用链逐个向api.kie.ai提交文生视频任务，每20秒轮询一次、每个模型最长等5分钟，成功后下载视频上传Google Drive，把任务键、视频链接、Drive文件ID、模型与消耗额度写回缓存表，最终向上游返回扁平结果或含原因的失败载荷。需HTTP Header Auth的Kie.ai密钥、Drive凭据、渲染台账表，模板未收费但模型调用另计。

这次做成什么

搭好这个子流程：先在本站示例字段结构上配置凭据与缓存表，再用一条虚构测试数据跑通「缓存未命中→Kie.ai出片→存Drive→写台账→二次调用命中缓存」的完整闭环。

准备什么

• n8n实例（云端或自托管，支持Data Table功能）
• Kie.ai账号与API密钥，用于创建HTTP Header Auth凭据
• Google账号并已配置Google Drive OAuth2凭据及目标文件夹
• 上游工作流或手动测试入口，能向子流程传prompt等字段

具体怎么做

1. 创建Kie.ai与Drive凭据

   在n8n凭据页新建HTTP Header Auth，名称如kie-api，Header名按模板中HTTP请求节点的写法（通常为Authorization），值填你的Kie.ai密钥；再新建Google Drive OAuth2凭据，授权后在Drive里建好存放成片的文件夹并记下folderId。

2. 建立渲染台账Data Table

   在n8n的Data Tables中新建一张表，列依次为jobKey、videoUrl、driveFileId、model、creditsConsumed、renderedAtMs；建好复制表ID，打开模板把两个Data Table节点里的占位YOUR_RENDER_LEDGER_TABLE_ID都替换成它。

3. 核对子流程输入与参数钳制

   打开模板的输入/参数归一化节点，确认它读取prompt，并可选读取durationSeconds、aspectRatio、resolution、firstFrameUrl、callbackUrl、modelChain；把本站示例映射表中的默认值填入你需要改的位置，模型链保留模板自带顺序即可。

4. 连接上游并发起首次测试

   在上游工作流加Execute Sub-workflow节点指向本子流程，传入下方artifacts中的测试JSON；执行一次，观察Kie.ai提交节点、20秒间隔轮询节点、Drive上传节点依次变绿，台账表新增一行。

5. 验证缓存命中路径

   用完全相同的prompt与参数再执行一次，因jobKey相同应直接走缓存分支返回，不再调用Kie.ai；检查返回的videoUrl与driveFileId与首次一致，且台账没有新增行。

可直接复制的材料

{
  "子流程输入示例": {
    "prompt": "一只橘猫在窗边看雨，电影感，缓慢推镜",
    "durationSeconds": 5,
    "aspectRatio": "16:9",
    "resolution": "720p"
  },
  "可选字段": ["firstFrameUrl", "callbackUrl", "modelChain"],
  "jobKey生成建议": "对prompt+时长+宽高比+分辨率拼接后取哈希，保证同参同键",
  "台账表列": ["jobKey", "videoUrl", "driveFileId", "model", "creditsConsumed", "renderedAtMs"],
  "轮询策略": "每个模型每20秒查询一次Kie.ai任务状态，单模型最长5分钟，失败或超时换下一个模型"
}

当返回failure时逐项核对：1) Kie.ai密钥是否过期或额度不足（看creditsConsumed与尝试记录）；2) 每个模型失败原因字段是超时（5分钟未出片）还是提交被拒；3) prompt是否触发内容限制，换一个中性提示词重试；4) Drive上传失败时检查folderId权限；5) 台账写入失败时确认表ID两处都已替换。

输入与输出示例

本站虚构演示，jobKey、文件ID、额度数字均为示例，未实际调用Kie.ai，具体模型名与扣费以模板和你的账号为准。

输入

{"prompt":"一只橘猫在窗边看雨，电影感，缓慢推镜","durationSeconds":5,"aspectRatio":"16:9","resolution":"720p"}

对应输出

首次执行（未命中缓存）返回：{"status":"success","videoUrl":"https://drive.google.com/file/d/1AbC示例/view","driveFileId":"1AbC示例","model":"备用链中首个成功的模型","creditsConsumed":12}；用相同输入第二次执行直接命中缓存，返回完全相同的videoUrl与driveFileId，creditsConsumed为0，未新增台账行。

做完检查这些

• 两次相同输入执行，第二次不产生新的Kie.ai调用且返回一致的Drive链接
• 台账Data Table中首次成功后恰好新增一行，六列全部有值
• 断掉Kie.ai凭据再跑一次，能返回包含已尝试模型与原因的failure载荷而非直接报错崩溃
• Drive目标文件夹里能看到首次成功上传的视频文件且可预览

容易卡住的地方

• 两个Data Table节点都要替换表ID，只改一个会导致查缓存或写缓存失败
• Kie.ai密钥与模型调用是第三方付费服务，模板免费不代表出片免费
• 参数稍有不同（如720p改1080p）jobKey就变，会重新出片扣额度
• 单模型最长5分钟、整条链更久，上游调用方要容忍子流程较长的执行时间