이미지 편집 API

이미지 편집 인터페이스는 원본 이미지를 기반으로 프롬프트에 따라 수정합니다(배경 교체, 요소 변경, 스타일화 등). GPT-Image 및 Gemini 이미지 시리즈 모두 사용 가능합니다.

인터페이스

POST https://api.4allapi.com/v1/images/edits

multipart/form-data 형식, 주요 필드:

필드	설명
model	이미지 모델명, 예: gpt-image-2, gemini-3.1-flash-image
image	원본 이미지 파일(여러 장 가능, image[])
prompt	편집 지시사항

예시

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gpt-image-2" \
  -F image="@product.png" \
  -F prompt="把背景换成温馨的圣诞客厅场景,保持商品主体不变"

resp = client.images.edit(
    model="gpt-image-2",
    image=open("product.png", "rb"),
    prompt="把背景换成海边日落场景",
)
print(resp.data[0].url or resp.data[0].b64_json[:50])

사용 시 주의사항

• 다중 이미지 입력(예: 상품 이미지 + 참조 스타일 이미지)은 순서대로 여러 image 필드를 전달하고, 프롬프트에서 각 이미지의 역할을 명시합니다;
• 편집도 동일하게 횟수 기준으로 과금되며, 화면 크기/해상도는 여전히 모델명 접미사로 제어됩니다;
• 인물/상품의 일관성을 유지하려면 프롬프트에 “주체를 변경하지 않음”을 명확히 지정하고, 원본 이미지와 해상도가 유사한 출력 형식을 우선적으로 사용하세요;
• 타임아웃 및 재시도 전략은 이미지 호출 주의사항을 참고하세요.