∞ UnlimitCanvas 创作工作台
技术手册 / 节点与模板 / api.定制化产出

api.定制化产出

30-节点与模板 · 引擎 api · 2026-08-22 · 1.7 KB
⚙ 前置条件 · API Key(云端服务商密钥):本节点走云端 API ⇒ 需先配该服务商自己的 Key:设置 → API Key 管理 → 新建 → 选服务商 → 填 API Key(⚠ 缺 Key 时依赖它的模板会直接从模板菜单消失,不是置灰)。⚠ WorkBuddy 积分通道不适用于本类节点 —— 它只服务文本大模型(AI 助手 / 自主 AI / AI 翻译这类"要 AI 自己想"的活,见《AI 能力接入》卷);要把这里的出图 / 出视频跑起来,仍须该服务商的 Key ✓。接入步骤见应用内帮助《开始前必配清单》。
模板ID:custom.provider.custom

基本信息

  • 功能:万能 API(customProvider):按产出类型定制化的通用远端 API 模板。输入支持:多文本 / 视频 / 图片数组 / 音频;输出支持:图片 / 视频 / 音频 / 文本,输出端口类型随「产出」参数所选类型实时刷新,方便下游节点识别。请求、响应解码与产出处置规则通过节点的 API 预设配置,选择不同的服务商预设即切换整套调用规则。
  • 类别:custom
  • 标签:api、custom

输入端口

  • 文本 1(文本,可选):文本输入(如提示词/指令),写入 body.texts.0。
  • 文本 2(文本,可选):第二段文本(如负面词/附加指令),写入 body.texts.1。
  • 视频输入(视频,可选):参考/驱动视频(图生视频或视频编辑),按 valueType 传 URL 或 data-uri。
  • 图片数组(图片,可选):一张或多张参考图(连接多个上游节点即组成数组),整体写入 body.images(数组)或 body.images.0 等单槽(按所选 API 预设配置)。
  • 尾帧图(图片,可选):首尾帧模式的尾帧参考图(如 MiniMax-Hailuo-02 首尾帧),按所选 API 预设映射到 body 字段。
  • 音频输入(音频,可选):参考音频(音频生成或视频配乐),按 valueType 传 URL 或 data-uri。

输出端口

  • 图片(图片):生成图片产物(responseMapping.image)。
  • 视频(视频):生成视频产物(responseMapping.video)。
  • 音频(音频):生成音频产物(responseMapping.audio)。
  • 文本(文本):生成文本产物(responseMapping.text)。

可调参数

  • 产出类型(select, 默认 image;选项:图片 / 视频 / 音频 / 文本;分组:产出)
  • 分辨率(select, 默认 720P;选项:480P / 720P / 1080P / 4K;分组:主要)
  • 宽高比(select, 默认 16:9;选项:16:9 / 9:16 / 1:1 / 4:3 / 3:4;分组:主要)
  • 时长(秒)(integer, 默认 5;分组:主要)
  • 媒体输入编码(select, 默认 data-uri;选项:data-uri(base64 内联) / url(公网地址);分组:输入分歧)
  • 图片数组传参(select, 默认 array;选项:array(整组数组) / flat(单槽/扁平化);分组:输入分歧)

提示词

  • 提示词占位说明:输入生成提示词
  • Agent 备注:通用自定义远端 API 模板。请求体字段、inputFields 覆盖(文本/视频/图片数组/音频的传参与参数名)、responseMapping(图片/视频/音频/文本的产出解码)均由节点的 API 预设提供,选择不同服务商预设即切换整套规则。图片数组按 body.images(数组)或 body.images.N(单槽)配置。

来源:E:/workbuddyProj/unlimitCanvas/ai_manual/node_rules/customProvider.md