logo
RunComfy
  • ComfyUI
  • EntrenadorNuevo
  • Modelos
  • API
  • Precios
discord logo
MODELOS
Explorar
Todos los modelos
BIBLIOTECA
Generaciones
APIS DE MODELOS
Documentación de la API
Claves API
CUENTA
Uso

Z Image Inpainting LoRA: inpainting preciso con control LoRA | RunComfy

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

Edita zonas enmascaradas con precisión, aplica hasta tres LoRAs cuando lo necesites y conserva de forma coherente la iluminación, los materiales y la composición.

Índice

1. Primeros pasos2. Autenticación3. Referencia de la APIEnviar una solicitudEstado de la solicitudObtener resultadosCancelar solicitud4. Archivos de entradaArchivo alojado (URL)5. EsquemaEsquema de entradaEsquema de salida

1. Primeros pasos

Usa la API de RunComfy para ejecutar tongyi-mai/z-image/turbo/inpainting/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/inpainting/lora \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the girl’s current top with a short red polka-dot swimsuit top. Keep the girl’s face, hairstyle, body proportions, and pose unchanged. The lighting should be natural and consistent with a beach environment, with realistic colors and details.",
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/input-1-1.png",
    "mask_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/mask.png"
  }'

2. Autenticación

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.

3. Referencia de la API

Enviar una solicitud

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/inpainting/lora \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Replace the girl’s current top with a short red polka-dot swimsuit top. Keep the girl’s face, hairstyle, body proportions, and pose unchanged. The lighting should be natural and consistent with a beach environment, with realistic colors and details.",
    "image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/input-1-1.png",
    "mask_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/mask.png"
  }'

Estado de la solicitud

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>"

Obtener resultados

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>"

Cancelar solicitud

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>"

4. Archivos de entrada

Archivo alojado (URL)

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.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt",
    "image_url",
    "mask_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "",
      "type": "string",
      "default": "Replace the girl’s current top with a short red polka-dot swimsuit top. Keep the girl’s face, hairstyle, body proportions, and pose unchanged. The lighting should be natural and consistent with a beach environment, with realistic colors and details."
    },
    "image_url": {
      "title": "Imagen",
      "description": "URL válida de la imagen de origen que se utilizará para el inpainting.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/input-1-1.png"
    },
    "mask_image_url": {
      "title": "Imagen de máscara",
      "description": "URL válida de la máscara que delimita la zona que se va a editar.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7294/media-files/mask.png"
    },
    "control_start": {
      "title": "Inicio del control",
      "description": "Punto inicial del condicionamiento de ControlNet, en una escala de 0 a 1.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0
    },
    "strength": {
      "title": "Intensidad de inpainting",
      "description": "Controla la intensidad del condicionamiento de inpainting.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "loras": {
      "title": "LoRAs",
      "description": "Lista de LoRAs que se aplicarán; admite un máximo de 3.",
      "type": "array",
      "items": {
        "path": {
          "title": "Ruta de LoRA",
          "description": "URL o ID de repositorio de HuggingFace (owner/repo) de los pesos LoRA.",
          "type": "string",
          "format": "str",
          "default": ""
        },
        "scale": {
          "title": "Intensidad de LoRA",
          "description": "Controla la intensidad 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"
    },
    "num_inference_steps": {
      "title": "Número de pasos de inferencia",
      "description": "Controla el número de pasos de difusión.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 20
    },
    "seed": {
      "title": "Semilla",
      "description": "",
      "type": "integer",
      "default": 0
    },
    "output_format": {
      "title": "Formato de salida",
      "description": "Define el formato de archivo de la imagen generada.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "control_scale": {
      "title": "Intensidad del control",
      "description": "Define la intensidad del condicionamiento de ControlNet para el inpainting.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.75
    },
    "control_end": {
      "title": "Fin del control",
      "description": "Punto final del condicionamiento de ControlNet, en una escala de 0 a 1.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.6
    }
  }
}

Esquema de salida

{
  "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"
        }
      }
    }
  }
}
Síguenos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Soporte
  • Discord
  • Correo electrónico
  • Estado del sistema
  • afiliado
Modelos de Video
  • Wan 2.6 Flash
  • Wan 2.6 Text to Video
  • Hailuo 2.3 Fast Standard
  • Happy Horse 1.1 reference to video
  • Seedance 2.5 Reference to Video
  • Seedance 2.0 Pro
  • Ver todos los modelos →
Modelos de Imagen
  • Seedream 5.0 Pro Image Edit
  • seedream 4.0
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • Nano Banana 2 Edit
  • GPT Image 2 Image Edit
  • Ver todos los modelos →
Legal
  • Términos de servicio
  • Política de privacidad
  • Política de cookies
RunComfy
Derechos de autor 2026 RunComfy. Todos los derechos reservados.

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.