Qwen Image 2.1：在 Models and API 上进行文字到图像和图像编辑 | RunComfy

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

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": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "输入图片",
      "description": "一到十张参考图片。顺序与提示匹配（第一张图片，第二张图片）。JPEG、PNG或WebP；每个文件最大30MB和25MP。在需要保持身份清晰时，保持四张或更少。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "validations": [
        {
          "validation_rule": "file_size_mb<",
          "validation_value": 30,
          "validation_error": "File size must be less than 30 MB."
        }
      ],
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7461/media-files/output-example1-4.webp"
      ]
    },
    "prompt": {
      "title": "编辑指令",
      "description": "用简单的语言描述更改：添加、删除、重新设计或替换的内容。引用任何文本以逐字呈现。对于遮罩，描述白色区域中应出现的内容。",
      "type": "string",
      "default": "Change the background to a warm golden-hour studio and add soft rim lighting, keep the subject and clothing unchanged."
    },
    "mask_url": {
      "title": "蒙版图片",
      "description": "可选的黑白本地编辑蒙版。白色标记要更改的区域；黑色保持不变。需要恰好一张参考图像，不能与透明背景配合使用，并且忽略纵横比和提示重写。",
      "type": "string"
    },
    "aspect_ratio": {
      "title": "宽高比（宽:高）",
      "description": "输出宽高比。自动使用第一个参考。在蒙版模式下忽略。",
      "type": "string",
      "enum": [
        "auto",
        "1:1",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "16:9",
        "9:16",
        "21:9",
        "9:21"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "分辨率",
      "description": "输出细节级别。1K 更快；2K 的像素大约是前者的四倍，成本更高。",
      "type": "string",
      "enum": [
        "1K",
        "2K"
      ],
      "default": "1K"
    },
    "background": {
      "title": "背景",
      "description": "对于普通照片是不透明的。透明会写入真实的 alpha 通道——只描述主体，不要使用 JPEG。不能与蒙版结合使用。",
      "type": "string",
      "enum": [
        "opaque",
        "transparent"
      ],
      "default": "opaque"
    },
    "output_format": {
      "title": "输出格式",
      "description": "PNG 和 WebP 可以携带 alpha 通道。JPEG 不能，因此它不能与透明背景结合使用。",
      "type": "string",
      "enum": [
        "png",
        "webp",
        "jpeg"
      ],
      "default": "png"
    },
    "enhance_prompt": {
      "title": "增强提示词",
      "description": "在编辑前，将简短的指令改写成更完整的情景。当指令已足够准确时，请关闭。在遮罩模式下忽略。",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "种子",
      "description": "用于可重复性的随机种子。每次运行使用 -1 可生成随机种子。",
      "type": "integer",
      "default": -1
    }
  }
}