FLUX 3 Image Edit：最高 4K 多參考圖片編輯 | Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
    ],
    "prompt": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
  }'

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": [
    "images",
    "prompt"
  ],
  "properties": {
    "images": {
      "title": "圖片",
      "description": "依照指令中提及的順序上傳一到十張原始圖片。每張圖片的寬和高均須至少為 256 像素，總像素數不得超過 400 萬。",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
      ]
    },
    "prompt": {
      "title": "提示詞",
      "description": "說明需要修改和保持不變的內容。依上傳順序以圖片 1、圖片 2 等指明圖片。將需要出現在圖片上的確切文字放在引號內。",
      "type": "string",
      "default": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
    },
    "aspect_ratio": {
      "title": "寬高比",
      "description": "輸出長寬比。auto 沿用第一張圖片的長寬比。",
      "type": "string",
      "enum": [
        "auto",
        "21:9",
        "2:1",
        "16:9",
        "3:2",
        "7:5",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "5:7",
        "2:3",
        "9:16",
        "1:2"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "解析度",
      "description": "輸出大小等級。這是唯一會改變價格的設定。",
      "type": "string",
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "default": "1k"
    },
    "enable_prompt_expansion": {
      "title": "啟用提示詞擴展",
      "description": "擴展簡短的指令，同時保留原本的編輯意圖和每張圖片的用途。",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "輸出格式",
      "description": "返回的靜態圖像的檔案類型。png 避免額外的 JPEG 壓縮。",
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ],
      "default": "jpeg"
    }
  }
}