Some checks are pending
Publish to Comfy registry / Publish Custom Node to registry (push) Waiting to run
2.6 KiB
2.6 KiB
媒体上传与路径记录
本参考用于把 Codex 上下文中的素材放入目标 ComfyUI input 目录。优先使用用户给出的 ComfyUI 地址;未提供地址时先读取 Easy Media 节点包 config.yaml 的 COMFYUI_URL,文件或字段不存在(含空值)时才回退至 http://127.0.0.1:8188。同一次工作流执行的上传、排队和历史查询必须使用同一实例。
地址解析与配置文件定位见 提交参考。以下 curl 示例中的本机地址需替换为解析后的地址。
上传到 input 子目录
项目的前端统一通过 ComfyUI /upload/image 接口上传图片、音频和视频,并传递 input 子目录:
curl --fail-with-body --silent --show-error \
-X POST http://127.0.0.1:8188/upload/image \
-F 'image=@/absolute/path/to/clip.mp4' \
-F 'type=input' \
-F 'overwrite=false' \
-F 'subfolder=codex/session-name'
响应通常为:
{"name":"clip.mp4","subfolder":"codex/session-name","type":"input"}
写入 TRACK_DATA 的 file_path 必须使用响应拼出的相对路径 subfolder/name,source_type 为 input。不要写上传前的本机绝对路径,也不要假设同名文件未被服务端改名。
通用根目录上传
POST /easy-media/upload 接受任意媒体文件并写入 input 根目录,但当前实现不支持子目录:
curl --fail-with-body --silent --show-error \
-X POST http://127.0.0.1:8188/easy-media/upload \
-F 'file=@/absolute/path/to/audio.wav'
响应为 {"file_name":"..."}。只有 /upload/image 不适用且用户不需要子目录时才使用此接口。
URL 素材
POST /easy-media/download-url 会把 URL 下载到 input 根目录:
curl --fail-with-body --silent --show-error \
-X POST http://127.0.0.1:8188/easy-media/download-url \
-H 'Content-Type: application/json' \
--data '{"url":"https://example.com/media.mp4"}'
如果用户希望保持远程引用而非下载,可在 TRACK_DATA 中使用 source_type: "url" 与 url 字段。不要在没有用户授权时把私有素材发送到远程服务。
上传后检查
- 为本次编辑选择稳定且不含
..的相对子目录,例如codex/<project-or-date>。 - 逐个检查 HTTP 状态和 JSON 响应;失败时停止,不把失败素材写入时间线。
- 同一素材只上传一次,复用返回路径。
- 可通过
GET /easy-media/media/recent?source=inputs&type=all&subfolder=...检查近期文件。 - 上传属于外部写入;dry-run 工作流补丁不会回滚已上传文件。