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": "URL, HuggingFace 저장소 ID(소유자/저장소)를 lora 가중치에 적용합니다.",
          "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": "결과를 개선하기 위해 자동 프롬프트 확장을 활성화합니다. 요청당 비용이 0.0025크레딧 증가합니다.",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "출력 형식",
      "description": "출력 이미지 형식을 지정합니다.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    }
  }
}