logo
RunComfy
  • ComfyUI
  • TreinadorNovo
  • Modelos
  • API
  • Preços
discord logo
MODELOS
Explorar
Todos os modelos
BIBLIOTECA
Gerações
APIS DE MODELOS
Documentação da API
Chaves API
CONTA
Uso

Z Image Turbo ControlNet: geração imagem a imagem com estrutura e LoRAs | RunComfy

tongyi-mai/z-image/turbo/controlnet/lora

Geração de guia com uma imagem de entrada, quatro modos de pré-processamento, tempo de controle de 0–1, até três LoRAs e etapas de inferência de 1–8.

Índice

1. Introdução2. Autenticação3. Referência da APIEnviar uma solicitaçãoStatus da solicitaçãoObter resultadosCancelar solicitação4. Arquivos de entradaArquivo hospedado (URL)5. EsquemaEsquema de entradaEsquema de saída

1. Introdução

Use a API RunComfy para executar tongyi-mai/z-image/turbo/controlnet/lora. Para entradas e saídas aceitas, consulte o 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
      }
    ]
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

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

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

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

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

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

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

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

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "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": "Imagem",
      "description": "URL da imagem de entrada usada para geração baseada em ControlNet.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7267/media-files/depth.jpg"
    },
    "loras": {
      "title": "LoRAs",
      "description": "Lista de LoRAs a serem aplicadas (máximo 3).",
      "type": "array",
      "default": [
        {
          "path": "alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union",
          "scale": 1
        }
      ],
      "items": {
        "path": {
          "title": "Caminho LoRA",
          "description": "URL, ID do repositório HuggingFace (proprietário/repo) para pesos lora.",
          "type": "string",
          "format": "str",
          "default": ""
        },
        "scale": {
          "title": "Escala LoRA",
          "description": "Escala do modelo LoRA.",
          "type": "float",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 4,
          "default": 1
        }
      },
      "maxItems": 3,
      "minItems": 0
    },
    "image_size": {
      "title": "Proporção (L:A)",
      "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 controle",
      "description": "Controla a intensidade com que as condições do ControlNet afetam a saída.",
      "type": "float",
      "default": 0.9,
      "minimum": 0,
      "maximum": 1
    },
    "control_start": {
      "title": "Início de controle",
      "description": "Especifica o ponto inicial do condicionamento ControlNet durante a geração.",
      "type": "float",
      "default": 0,
      "minimum": 0,
      "maximum": 1
    },
    "control_end": {
      "title": "Fim do controle",
      "description": "Especifica o ponto final do condicionamento ControlNet durante a geração.",
      "type": "float",
      "default": 0.4,
      "minimum": 0,
      "maximum": 1
    },
    "preprocess": {
      "title": "Pré-processar",
      "description": "Define qual pré-processamento (se houver) será aplicado à imagem de entrada do ControlNet.",
      "type": "string",
      "enum": [
        "none",
        "canny",
        "depth",
        "pose"
      ],
      "default": "none"
    },
    "num_inference_steps": {
      "title": "Número de etapas de inferência",
      "description": "Especifica o número de etapas de inferência durante a geração.",
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 8
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "default": 0
    },
    "enable_prompt_expansion": {
      "title": "Prompt Mágico",
      "description": "Permite a expansão automática de prompts para melhorar os resultados; aumenta o custo em 0,0025 créditos por solicitação.",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "Formato de saída",
      "description": "Especifica o formato da imagem de saída.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Siga-nos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Suporte
  • Discord
  • E-mail
  • Status do Sistema
  • afiliado
Modelos de Vídeo
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • Ver todos os modelos →
Modelos de Imagem
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Ver todos os modelos →
Legal
  • Termos de Serviço
  • Política de Privacidade
  • Política de Cookies
RunComfy
Copyright 2026 RunComfy. Todos os Direitos Reservados.

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.