API

구글 이미지 편집

요약

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

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

POST

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

Authorization: Bearer {api-key}

model

string

required

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

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

prompt

string

required

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

reference_images

array

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

하위 속성 표시

config

object

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

하위 속성 표시

edit_mode

string

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

negative_prompt

string

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

mask_mode

string

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

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