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