이 페이지는 Legacy API 문서입니다. 현재 API Gateway의 새 문서로 통합·이전될 예정이며, 신규 통합에는 API Gateway 사용을 권장합니다.

구글 이미지 편집

기존 이미지에 변화를 주고 싶을 때, 이 API를 사용해보세요. 프롬프트와 함께 참조 이미지나 편집 모드를 설정하면, 배경 교체, 요소 삽입/제거, 스타일 변환 등 다양한 방식으로 이미지를 자유롭게 수정할 수 있습니다.

SDK: 구글 AI SDK

API	지원 모델
google/models/edit-image	`imagen-3.0-capability-001`

이미지 편집 생성

POST/v1/api/google/models/edit-image

요청 헤더

파라미터

model

string

required

이미지 생성에 사용되는 모델의 이름입니다.

현재 지원 모델은 imagen-3.0-capability-001입니다.

prompt

string

required

생성하고자 하는 이미지의 텍스트 설명입니다.

reference_images

array

생성 과정을 안내하는 데 사용되는 참조 이미지 배열. 각 이미지 객체에는 메타데이터와 이미지 데이터가 포함됩니다.

하위 속성 표시

config

object

이미지 생성 구성 설정을 포함하는 선택적 객체.

하위 속성 표시

edit_mode

string

이미지 편집 또는 생성 모드를 정의합니다. 예: EDIT_MODE_DEFAULT (기본 동작, 특별한 편집 없음)

EDIT_MODE_DEFAULT 기본 이미지 생성 모드 (특별한 편집 없음)
EDIT_MODE_BGSWAP 배경을 다른 배경으로 교체 (배경 교체)
EDIT_MODE_CONTROLLED_EDITING 제어 가능한 편집을 지원 (사용자가 정의한 방향성 반영)
EDIT_MODE_INPAINT_INSERTION 기존 이미지 위에 새 요소 삽입 (삽입형 인페인팅)
EDIT_MODE_INPAINT_REMOVAL 기존 이미지에서 특정 요소 제거 (제거형 인페인팅)
EDIT_MODE_OUTPAINT 이미지 외곽을 확장하여 새로운 요소 생성 (아웃페인팅)
EDIT_MODE_PRODUCT_IMAGE 제품 이미지용 최적화 모드 (배경 제거 등 포함 가능)
EDIT_MODE_STYLE 스타일 변환 전용 모드 (화풍 변화 등 적용)

negative_prompt

string

이미지 편집 시 포함하지 않을 요소를 지정합니다.

mask_mode

string

편집을 위한 마스크 모드를 결정합니다. 옵션:

MASK_MODE_BACKGROUND: 사용자 제공 마스크 없이 배경을 자동으로 마스킹
MASK_MODE_FOREGROUND: 전경 요소 마스킹
MASK_MODE_SEMANTIC: 의미 기반 마스킹

mask_dilation

float

마스크를 확장할 비율 (이미지 너비 대비 백분율). 불완전한 입력 마스크를 보정하는 데 유용합니다. 권장값: 0.01 범위: 0.0-1.0

edit_steps

integer

기본 모델의 샘플링 단계 수입니다. 값이 높을수록 품질이 향상되지만 지연 시간이 증가합니다. 범위: 35-75 (기본값은 편집 모드에 따라 상이, 인페인팅 삽입은 35에서 시작)

person_generation

string

인간과 유사한 형태의 생성 가능 여부를 제어합니다. 예: "DONT_ALLOW" (사람 생성 비허용)

seed

integer

결정론적 생성을 위한 시드값. 같은 시드와 구성으로 반복 생성 시 동일한 결과를 보장합니다. 예: 42

number_of_images

integer

생성할 이미지 수. 일부 모델은 다중 이미지를 지원하고(예: GPT 기반), 일부는 1개만 반환합니다(예: DALL·E 3). 범위: 1–10 예: 1

aspect_ratio

string

화면 비율 설정. 예: 1:1 (정사각형 비율)

output_mime_type

string

출력 이미지 포맷 지정. 예: image/jpeg 또는 image/png, image/webp

마지막 수정 날짜: May 07, 2025

/models/generate-images

/chat/completions

요청 예시

curl https://factchat-cloud.mindlogic.ai/v1/api/google/models/edit-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{
    "model": "imagen-3.0-capability-001",
    "prompt": "Transform this urban scene into a futuristic cyberpunk city with neon lights and flying cars",
    "reference_images": [
      {
        "reference_id": 1,
        "reference_image": {
          "image_bytes": "<base64 encoded image>",
          "mime_type": "image/jpeg"
        }
      }
    ],
    "config": {
      "edit_mode": "EDIT_MODE_DEFAULT",
      "person_generation": "DONT_ALLOW",
      "seed": 42,
      "number_of_images": 1,
      "aspect_ratio": "1:1",
      "output_mime_type": "image/jpeg"
    }
  }'

// https://factchat-cloud.mindlogic.ai/v1/api/google/models/edit-image
{
  "model": "imagen-3.0-capability-001",
  "prompt": "Transform this urban scene into a futuristic cyberpunk city with neon lights and flying cars",
  "reference_images": [
    {
      "reference_id": 1,
      "reference_image": {
        "image_bytes": "<base64 encoded image>",
        "mime_type": "image/jpeg"
      }
    }
  ],
  "config": {
    "edit_mode": "EDIT_MODE_DEFAULT",
    "person_generation": "DONT_ALLOW",
    "seed": 42,
    "number_of_images": 1,
    "aspect_ratio": "1:1",
    "output_mime_type": "image/jpeg"
  }
}

const response = await fetch("https://factchat-cloud.mindlogic.ai/v1/api/google/models/edit-image", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_GEMINI_API_KEY"
  },
  body: JSON.stringify({
    model: "imagen-3.0-capability-001",
    prompt: "Transform this urban scene into a futuristic cyberpunk city with neon lights and flying cars",
    reference_images: [
      {
        reference_id: 1,
        reference_image: {
          image_bytes: "<base64 encoded image>",
          mime_type: "image/jpeg"
        }
      }
    ],
    config: {
      edit_mode: "EDIT_MODE_DEFAULT",
      person_generation: "DONT_ALLOW",
      seed: 42,
      number_of_images: 1,
      aspect_ratio: "1:1",
      output_mime_type: "image/jpeg"
    }
  })
});

const result = await response.json();
console.log(result.data?.[0]); // 이미지 응답 처리

응답 예시

{
    "generatedImages": [
        {
            "image": {
                "gcsUri": null,
                "imageBytes": "/9j/4SkRgBA..." //base64,
                "mimeType": "image/jpeg"
            },
            "raiFilteredReason": null,
            "safetyAttributes": {
                "categories": null,
                "scores": null,
                "contentType": null
            },
            "enhancedPrompt": null
        }
    ]
}