FLUX.2 이미지 편집 API: 참조 이미지 조합과 사용법

curl --fail-with-body --max-time 300 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-pro",
    "prompt": "주요 피사체는 그대로 두세요. 배경을 깔끔한 연한 파란색 스튜디오 배경으로 바꾸고 원래 조명은 유지하세요.",
    "input_image": "https://example.com/source.png",
    "width": 1792,
    "height": 1024,
    "output_format": "png"
  }' \
  -o flux-edit.json

python3 save_images.py flux-edit.json flux-edit

IMG=$(base64 < product.png | tr -d '\n')

curl --fail-with-body --max-time 300 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- \
  -o flux-local-edit.json <<EOF
{
  "model": "flux-2-pro",
  "prompt": "부드러운 아침 햇살이 드는 대리석 카운터 위에 제품을 놓아 주세요. 제품과 라벨은 바꾸지 마세요.",
  "input_image": "data:image/png;base64,$IMG",
  "size": "1024x1024",
  "output_format": "png"
}
EOF

python3 save_images.py flux-local-edit.json flux-product

IMG1=$(base64 < robot.png | tr -d '\n')
IMG2=$(base64 < greenhouse.png | tr -d '\n')
IMG3=$(base64 < skateboard.png | tr -d '\n')

curl --fail-with-body --max-time 300 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- \
  -o flux-multi-edit.json <<EOF
{
  "model": "flux-2-pro",
  "prompt": "세 참조 이미지를 하나의 자연스러운 새 이미지로 합쳐 주세요. 이미지 1은 빨간 로봇, 이미지 2는 청록색 유리 온실 배경, 이미지 3은 노란 스케이트보드입니다. 세 이미지의 디테일을 모두 살리고, 콜라주나 화면 분할 구성은 만들지 마세요.",
  "input_image": "data:image/png;base64,$IMG1",
  "input_image_2": "data:image/png;base64,$IMG2",
  "input_image_3": "data:image/png;base64,$IMG3",
  "width": 1792,
  "height": 1024,
  "output_format": "png"
}
EOF

python3 save_images.py flux-multi-edit.json flux-multi-edit

import base64
import mimetypes
import os
from pathlib import Path

import requests

API_URL = "https://api.laozhang.ai/v1/images/generations"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}


def to_image_input(source):
    """URL은 그대로 반환하고, 로컬 파일은 data URL로 변환합니다."""
    if source.startswith(("https://", "http://", "data:")):
        return source
    path = Path(source)
    mime_type = mimetypes.guess_type(path.name)[0] or "image/png"
    encoded = base64.b64encode(path.read_bytes()).decode("ascii")
    return f"data:{mime_type};base64,{encoded}"


def flux_edit(prompt, sources, width=1024, height=1024, model="flux-2-pro"):
    if not 1 <= len(sources) <= 8:
        raise ValueError("FLUX.2 참조 이미지는 1~8장이어야 합니다")
    payload = {
        "model": model,
        "prompt": prompt,
        "width": width,
        "height": height,
        "output_format": "png",
    }
    for number, source in enumerate(sources, start=1):
        field = "input_image" if number == 1 else f"input_image_{number}"
        payload[field] = to_image_input(source)
    response = requests.post(API_URL, headers=HEADERS, json=payload, timeout=240)
    response.raise_for_status()
    return response.json()


def save_first_image(result, stem):
    # FLUX가 반환하는 URL은 10분 후 만료되므로 바로 내려받습니다.
    download = requests.get(result["data"][0]["url"], timeout=120)
    download.raise_for_status()
    image = download.content
    extension = "png" if image.startswith(b"\x89PNG") else "jpg"
    path = Path(f"{stem}.{extension}")
    path.write_bytes(image)
    return path


result = flux_edit(
    "이미지 1은 빨간 로봇, 이미지 2는 온실 배경, 이미지 3은 노란 스케이트보드입니다. "
    "콜라주가 아닌 하나의 자연스러운 새 장면을 만들어 주세요.",
    ["robot.png", "greenhouse.png", "skateboard.png"],
    width=1792,
    height=1024,
)
print("저장 완료:", save_first_image(result, "flux-python-edit"))

이미지 1은 캐릭터, 이미지 2는 배경, 이미지 3은 제품입니다.
하나의 자연스러운 상업 포스터를 만들어 주세요.
캐릭터의 옷차림, 배경의 조명, 제품 로고는 그대로 유지하세요.
콜라주나 화면 분할 구성은 만들지 마세요.