API Qwen Qwen Image 3.0 Edit | Precios y documentación

qwen/qwen-image-3.0/edit

Qwen Image 3.0 Edit transforma una imagen cargada a partir de instrucciones en lenguaje natural, con salida de 1K o 2K, control de relación de aspecto, expansión rápida y reproducibilidad basada en semillas.

Índice

1. Primeros pasos

Usa la API de RunComfy para ejecutar qwen/qwen-image-3.0/edit. Para entradas y salidas admitidas, consulta el esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-3.0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
  }'

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/qwen/qwen-image-3.0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
  }'

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": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "Imagen(es) de entrada",
      "description": "De una a tres imágenes para editar. La edición sigue tus instrucciones manteniendo el resto de la imagen.",
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
      ]
    },
    "prompt": {
      "title": "Instrucción de edición",
      "description": "Describa el cambio en lenguaje sencillo, p. qué agregar, eliminar, cambiar el estilo o reemplazar. Cite cualquier texto para traducirlo palabra por palabra.",
      "type": "string",
      "default": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
    },
    "resolution": {
      "title": "Resolución",
      "description": "Nivel de detalle de salida. Elija 1k para borradores más rápidos o 2k para obtener el máximo detalle.",
      "type": "string",
      "enum": [
        "1k",
        "2k"
      ],
      "default": "2k"
    },
    "aspect_ratio": {
      "title": "Relación de aspecto (An:Al)",
      "description": "La relación de aspecto de la imagen generada.",
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ],
      "default": "1:1"
    },
    "enable_prompt_expansion": {
      "title": "Activar expansión de prompt",
      "description": "Deje que el modelo enriquezca un breve mensaje con detalles adicionales antes de generarlo. Desactívelo cuando su indicación ya sea precisa.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Semilla aleatoria para reproducibilidad. Utilice -1 para obtener una semilla aleatoria en cada ejecución.",
      "type": "integer",
      "default": -1
    }
  }
}

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

RunComfy

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.

1. Primeros pasos

Usa la API de RunComfy para ejecutar qwen/qwen-image-3.0/edit. Para entradas y salidas admitidas, consulta el esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/qwen/qwen-image-3.0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
  }'

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/qwen/qwen-image-3.0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
    ],
    "prompt": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
  }'

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)

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "Imagen(es) de entrada",
      "description": "De una a tres imágenes para editar. La edición sigue tus instrucciones manteniendo el resto de la imagen.",
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7425/media-files/output-example1-5.webp"
      ]
    },
    "prompt": {
      "title": "Instrucción de edición",
      "description": "Describa el cambio en lenguaje sencillo, p. qué agregar, eliminar, cambiar el estilo o reemplazar. Cite cualquier texto para traducirlo palabra por palabra.",
      "type": "string",
      "default": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject unchanged."
    },
    "resolution": {
      "title": "Resolución",
      "description": "Nivel de detalle de salida. Elija 1k para borradores más rápidos o 2k para obtener el máximo detalle.",
      "type": "string",
      "enum": [
        "1k",
        "2k"
      ],
      "default": "2k"
    },
    "aspect_ratio": {
      "title": "Relación de aspecto (An:Al)",
      "description": "La relación de aspecto de la imagen generada.",
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ],
      "default": "1:1"
    },
    "enable_prompt_expansion": {
      "title": "Activar expansión de prompt",
      "description": "Deje que el modelo enriquezca un breve mensaje con detalles adicionales antes de generarlo. Desactívelo cuando su indicación ya sea precisa.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Seed",
      "description": "Semilla aleatoria para reproducibilidad. Utilice -1 para obtener una semilla aleatoria en cada ejecución.",
      "type": "integer",
      "default": -1
    }
  }
}

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

Edición de Qwen Image 3.0: edición de imágenes con IA en modelos y API | Corre cómodo | Models and API | RunComfy

Qwen Image 3.0 Edit transforma una imagen cargada a partir de instrucciones en lenguaje natural, con salida de 1K o 2K, control de relación de aspecto, expansión rápida y reproducibilidad basada en semillas.

Índice

1. Primeros pasos

2. Autenticación

3. Referencia de la API

Enviar una solicitud

Estado de la solicitud

Obtener resultados

Cancelar solicitud

4. Archivos de entrada

Archivo alojado (URL)

5. Esquema

Esquema de entrada

Esquema de salida

Edición de Qwen Image 3.0: edición de imágenes con IA en modelos y API | Corre cómodo | Models and API | RunComfy

Qwen Image 3.0 Edit transforma una imagen cargada a partir de instrucciones en lenguaje natural, con salida de 1K o 2K, control de relación de aspecto, expansión rápida y reproducibilidad basada en semillas.

Índice

1. Primeros pasos

2. Autenticación

3. Referencia de la API

Enviar una solicitud

Estado de la solicitud

Obtener resultados

Cancelar solicitud

4. Archivos de entrada

Archivo alojado (URL)

5. Esquema

Esquema de entrada

Esquema de salida