Usa la API de RunComfy para ejecutar tongyi-mai/z-image/turbo/controlnet/lora. Para entradas y salidas admitidas, consulta el esquema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/tongyi-mai/z-image/turbo/controlnet/lora \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "ultra-realistic interior rendering of a modern minimalist apartment living space with floor-to-ceiling glass windows on the right side, filling the room with soft natural daylight. A sleek light gray sectional sofa and a low rectangular coffee table with a matte finish sit on pale wood flooring. The walls are smooth and painted white, creating a clean and airy aesthetic. In the background, a green indoor plant adds a subtle touch of nature. The composition features high ceilings, long hallway perspective, and a serene, uncluttered atmosphere. Rendered in 8k, photorealistic, global illumination, unreal engine, architectural photography style, shot with a wide-angle lens, soft shadows, natural lighting.",
"image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7267/media-files/depth.jpg",
"loras": [
{
"path": "alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union",
"scale": 1
}
]
}'Define la variable de entorno YOUR_API_TOKEN con tu clave API (gestión en Perfil) e incluye en cada solicitud un token Bearer en la cabecera Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Envía un trabajo de generación asíncrono y recibe de inmediato un request_id y URLs para consultar estado, obtener resultados y cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/tongyi-mai/z-image/turbo/controlnet/lora \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "ultra-realistic interior rendering of a modern minimalist apartment living space with floor-to-ceiling glass windows on the right side, filling the room with soft natural daylight. A sleek light gray sectional sofa and a low rectangular coffee table with a matte finish sit on pale wood flooring. The walls are smooth and painted white, creating a clean and airy aesthetic. In the background, a green indoor plant adds a subtle touch of nature. The composition features high ceilings, long hallway perspective, and a serene, uncluttered atmosphere. Rendered in 8k, photorealistic, global illumination, unreal engine, architectural photography style, shot with a wide-angle lens, soft shadows, natural lighting.",
"image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7267/media-files/depth.jpg",
"loras": [
{
"path": "alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union",
"scale": 1
}
]
}'Obtiene el estado actual de un request_id ("in_queue", "in_progress", "completed" o "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Obtiene las salidas finales y metadatos del request_id; si el trabajo no ha terminado, la respuesta devuelve el estado actual para seguir haciendo polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancela un trabajo en cola por request_id; los trabajos en curso no se pueden cancelar.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Proporciona una URL HTTPS públicamente accesible. El host debe permitir peticiones del servidor (sin login/cookies), sin rate limit agresivo ni bloqueo de bots. Recomendado: imágenes ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min a 720p). Para activos privados, URLs estables o firmadas.
{
"type": "object",
"title": "Esquema de entrada",
"required": [
"prompt",
"image_url",
"loras"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "",
"type": "string",
"default": "ultra-realistic interior rendering of a modern minimalist apartment living space with floor-to-ceiling glass windows on the right side, filling the room with soft natural daylight. A sleek light gray sectional sofa and a low rectangular coffee table with a matte finish sit on pale wood flooring. The walls are smooth and painted white, creating a clean and airy aesthetic. In the background, a green indoor plant adds a subtle touch of nature. The composition features high ceilings, long hallway perspective, and a serene, uncluttered atmosphere. Rendered in 8k, photorealistic, global illumination, unreal engine, architectural photography style, shot with a wide-angle lens, soft shadows, natural lighting."
},
"image_url": {
"title": "Imagen",
"description": "URL de la imagen de entrada utilizada para la generación basada en ControlNet.",
"type": "string",
"default": "https://playgrounds-storage-public.runcomfy.net/tools/7267/media-files/depth.jpg"
},
"loras": {
"title": "LoRA",
"description": "Listado de LoRAs a aplicar (máximo 3).",
"type": "array",
"default": [
{
"path": "alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union",
"scale": 1
}
],
"items": {
"path": {
"title": "Camino LoRA",
"description": "URL, ID del repositorio de HuggingFace (propietario/repositorio) para los pesos de lora.",
"type": "string",
"format": "str",
"default": ""
},
"scale": {
"title": "Escala LoRA",
"description": "Escala del modelo LoRA.",
"type": "float",
"format": "float_slider_with_range",
"minimum": 0,
"maximum": 4,
"default": 1
}
},
"maxItems": 3,
"minItems": 0
},
"image_size": {
"title": "Relación de aspecto (An:Al)",
"description": "",
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9",
"auto"
],
"default": "auto"
},
"control_scale": {
"title": "Escala de control",
"description": "Controla la fuerza con la que las condiciones de ControlNet afectan la salida.",
"type": "float",
"default": 0.9,
"minimum": 0,
"maximum": 1
},
"control_start": {
"title": "Inicio de control",
"description": "Especifica el punto de inicio del acondicionamiento ControlNet durante la generación.",
"type": "float",
"default": 0,
"minimum": 0,
"maximum": 1
},
"control_end": {
"title": "Control final",
"description": "Especifica el punto final del acondicionamiento ControlNet durante la generación.",
"type": "float",
"default": 0.4,
"minimum": 0,
"maximum": 1
},
"preprocess": {
"title": "Preproceso",
"description": "Define qué preprocesamiento (si corresponde) se aplicará a la imagen de entrada de ControlNet.",
"type": "string",
"enum": [
"none",
"canny",
"depth",
"pose"
],
"default": "none"
},
"num_inference_steps": {
"title": "Número de pasos de inferencia",
"description": "Especifica el número de pasos de inferencia durante la generación.",
"type": "integer",
"default": 8,
"minimum": 1,
"maximum": 8
},
"seed": {
"title": "Semilla",
"description": "",
"type": "integer",
"default": 0
},
"enable_prompt_expansion": {
"title": "Mensaje mágico",
"description": "Permite la expansión rápida automática para mejorar los resultados; aumenta el costo en 0.0025 créditos por solicitud.",
"type": "boolean",
"default": false
},
"output_format": {
"title": "Formato de salida",
"description": "Especifica el formato de la imagen de salida.",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL de una sola imagen"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL de un solo vídeo"
},
"images": {
"type": "array",
"description": "varias URLs de imagen",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "varias URLs de vídeo",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy es la principal ComfyUI plataforma, ofreciendo ComfyUI en línea entorno y servicios, junto con flujos de trabajo de ComfyUI con impresionantes imágenes. RunComfy también ofrece AI Models, permitiendo a los artistas aprovechar las últimas herramientas de AI para crear arte increíble.