이미지

이미지 편집

multipart/form-data로 소스 이미지를 업로드하고 텍스트 프롬프트로 편집합니다. OpenAI client.images.edit()와 호환됩니다. 내부적으로 image-to-image 파이프라인을 재사용하며 응답은 항상 동기 JSON입니다. mask는 아직 미지원이며 response_format은 URL만 지원합니다(b64_json 거부).

POST/api/v1/images/edits

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

image필수

file

편집할 소스 이미지 파일. 여러 파일은 image 필드 반복(또는 image[]) 사용 — 최대 8개, 각 10 MB, MIME은 image/* 필수.

≤ 8 files, ≤ 10 MB each, image/*

prompt필수

string

적용할 편집 내용의 텍스트 설명.

minLength: 1

Example: "change the background to a night city"

model

string

이미지 편집 모델. 생략 시 서버 기본값(현재 gpt-5.4-image-2) 적용.

Example: "openai/gpt-5.4-image-2"

n

integer

생성할 결과 수, 1–10.

1–10

Example: 1

size

string

출력 크기. "<너비>x<높이>" 픽셀 형식 필수(예: 1024x1024). 다른 형식은 조용히 무시됩니다.

format: <width>x<height>

Example: "1024x1024"

심층 가이드 →

POST /api/v1/images/edits

1
2
3
4
5
curl https://bazaarlink.ai/api/v1/images/edits \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -F model="openai/gpt-5.4-image-2" \
  -F image=@cat.png \
  -F prompt="change the background to a night city"

응답 예시

성공. 항상 동기 JSON을 반환합니다(SSE 스트림은 내부에서 처리). client.images.edit()와 호환.

1
2
3
4
5
6
7
8
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ]
}