Files
fn_registry/python/functions/ml/comfyui_submit_workflow.md
T
egutierrez cda36408d0 feat(ml): modelos con prefijo de categoría (IMG_/VIDEO_/3D_) + refs actualizadas
Renombra los 13 checkpoints/diffusion models de ComfyUI prefijando la
categoría al inicio del nombre, para que en el dropdown de carga el usuario
distinga de inmediato imagen/vídeo/3D y no cargue un modelo en el nodo
equivocado. Misma operación que se hizo con los LoRAs (report 0197) pero
sobre los modelos.

Clasificación:
- IMG_: dreamshaper_8, juggernaut_xl_v11, v1-5-pruned-emaonly-fp16,
  flux1-dev-fp8-e4m3fn, flux1-schnell-fp8-e4m3fn
- VIDEO_: svd, ltx-video-2b-v0.9.5, wan2.1_t2v_1.3B_fp16
- 3D_: stable_zero123, sv3d_p, hunyuan3d-dit-v2-mini, hunyuan3d-dit-v2-mv,
  hy3dgen/hunyuan3d-dit-v2-0-fp16 (mantiene subcarpeta)

A diferencia de los LoRAs aquí solo se PREFIJA la categoría conservando el
nombre completo (versión/arquitectura). Archivos físicos renombrados en
~/ComfyUI/models/checkpoints, /mnt/2tb/comfyui_models/{checkpoints,
diffusion_models} y la subcarpeta hy3dgen/. Mapa de reversión en
~/ComfyUI/models/checkpoints/_ckpt_rename_map.json.

Actualiza todas las refs (ckpt_name/unet_name + defaults + prosa) en los
builders gamedev/vídeo/3D, style presets, pipelines, tests y los workflows
de ComfyUI. Arregla de paso el default roto de comfyui_text_to_3d_oneshot
(apuntaba a v1-5-pruned-emaonly.safetensors inexistente; ahora al real
IMG_v1-5-pruned-emaonly-fp16.safetensors).

No tocados (justificado): repo-paths de HuggingFace en comfyui_install_3d_model
(<repo>/model.fp16.safetensors son rutas de descarga, no nombres de dropdown)
y el mock de stable-diffusion.cpp en test_genconfig_to_sdcpp_args.

Verificado: dropdowns CheckpointLoaderSimple + UNETLoader listan los nombres
con prefijo; 1 generación real con IMG_juggernaut_xl_v11 (node_errors vacío,
pixelart_00003_.png); 327 tests comfyui verdes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-27 18:24:52 +02:00

3.0 KiB

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
name kind lang domain version purity signature description tags uses_functions uses_types returns returns_optional error_type imports params output tested tests test_file_path file_path
comfyui_submit_workflow function py ml 1.0.0 impure def comfyui_submit_workflow(workflow: dict, server: str = "127.0.0.1:8188", client_id: str | None = None, timeout: float = 30.0) -> dict Envia un workflow (API format) a ComfyUI via POST /prompt. Devuelve la respuesta con prompt_id y number (posicion en cola). Si ComfyUI rechaza el workflow (HTTP 400) propaga el cuerpo con los detalles de validacion por nodo. Impura: HTTP POST, solo stdlib (urllib, json, uuid).
comfyui
ml
image-generation
stable-diffusion
http
queue
false error_go_core
name desc
workflow dict en API format (resultado de comfyui_build_txt2img_workflow u otro builder). Claves = node_ids, valores con class_type + inputs.
name desc
server host:port del servidor ComfyUI sin esquema (default '127.0.0.1:8188').
name desc
client_id Identificador de cliente para correlar eventos. None genera un uuid4; el id usado se devuelve en la respuesta.
name desc
timeout Timeout de la peticion HTTP en segundos.
dict de respuesta de ComfyUI con prompt_id (str, para comfyui_wait_result), number (int, posicion en cola), node_errors (dict) y la clave anadida client_id (str usado en la peticion). false
python/functions/ml/comfyui_submit_workflow.py

Ejemplo

import sys, os
sys.path.insert(0, os.path.join(os.environ["HOME"], "fn_registry", "python", "functions"))
from ml.comfyui_build_txt2img_workflow import comfyui_build_txt2img_workflow
from ml.comfyui_submit_workflow import comfyui_submit_workflow

wf = comfyui_build_txt2img_workflow(
    ckpt_name="IMG_v1-5-pruned-emaonly-fp16.safetensors",
    positive="a red apple on a wooden table, sharp focus",
    negative="blurry, low quality",
)
resp = comfyui_submit_workflow(wf)
prompt_id = resp["prompt_id"]       # pasalo a comfyui_wait_result
print(prompt_id, resp.get("number"))

O lanzable directo (build + submit) con: ./fn run comfyui_submit_workflow.

Cuando usarla

Tras construir un workflow con comfyui_build_txt2img_workflow, para encolarlo en el servidor y obtener el prompt_id. Es el segundo paso del round-trip build -> submit -> wait. Reutiliza el client_id que devuelve si vas a correlar varios prompts del mismo cliente.

Gotchas

  • ComfyUI encola y devuelve de inmediato; NO espera a que termine la generacion. Para recuperar el resultado usa comfyui_wait_result con el prompt_id.
  • Si el workflow es invalido (checkpoint inexistente, conexion mal tipada, input fuera de rango) ComfyUI responde HTTP 400 y esta funcion lanza RuntimeError con el cuerpo de validacion del nodo afectado. Leelo: el detalle dice que nodo y que input fallo.
  • Encolar tiene efecto secundario: arranca trabajo de GPU en el servidor. No es idempotente — cada llamada encola un prompt nuevo.