Z Image Turbo ControlNet：支持 LoRA 的结构引导图片到图片生成 | RunComfy

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
      }
    ]
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "输入结构",
  "required": [
    "prompt",
    "image_url",
    "loras"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "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": "参考图片",
      "description": "ControlNet 输入图片的 URL。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7267/media-files/depth.jpg"
    },
    "loras": {
      "title": "LoRA 列表",
      "description": "要应用的 LoRA 列表，最多 3 项。",
      "type": "array",
      "default": [
        {
          "path": "alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union",
          "scale": 1
        }
      ],
      "items": {
        "path": {
          "title": "LoRA 路径",
          "description": "LoRA 权重的 URL 或 Hugging Face 仓库 ID（owner/repo）。",
          "type": "string",
          "format": "str",
          "default": ""
        },
        "scale": {
          "title": "LoRA 强度",
          "description": "LoRA 模型的应用强度。",
          "type": "float",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 4,
          "default": 1
        }
      },
      "maxItems": 3,
      "minItems": 0
    },
    "image_size": {
      "title": "图片尺寸",
      "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": "控制强度",
      "description": "ControlNet 条件影响结果的强度。",
      "type": "float",
      "default": 0.9,
      "minimum": 0,
      "maximum": 1
    },
    "control_start": {
      "title": "控制开始位置",
      "description": "ControlNet 条件在生成过程中的开始位置。",
      "type": "float",
      "default": 0,
      "minimum": 0,
      "maximum": 1
    },
    "control_end": {
      "title": "控制结束位置",
      "description": "ControlNet 条件在生成过程中的结束位置。",
      "type": "float",
      "default": 0.4,
      "minimum": 0,
      "maximum": 1
    },
    "preprocess": {
      "title": "预处理方式",
      "description": "对 ControlNet 输入图片应用的预处理方式。",
      "type": "string",
      "enum": [
        "none",
        "canny",
        "depth",
        "pose"
      ],
      "default": "none"
    },
    "num_inference_steps": {
      "title": "推理步数",
      "description": "生成时使用的推理步数。",
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 8
    },
    "seed": {
      "title": "随机种子",
      "description": "用于改变或复现结果的随机种子。",
      "type": "integer",
      "default": 0
    },
    "enable_prompt_expansion": {
      "title": "提示词扩展",
      "description": "启用时自动扩展提示词。",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "输出格式",
      "description": "生成文件的输出格式。",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    }
  }
}