이미지 변형 생성

모델 기능에 따라 변형 개수, 크기 및 응답 형식을 제어할 수 있습니다.

POST/v1/images/variations

단일 입력 이미지에서 하나 이상의 시각적 변형을 생성합니다. 입력 이미지는 선택한 모델이 지원하는 형식, 파일 크기 및 이미지 크기 요구 사항을 충족해야 합니다.

이미지 변형 지원 여부는 현재 API 키에 표시되는 모델의 실제 기능을 따릅니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

multipart/form-data

Multipart로 변형의 원본 이미지를 제출합니다. 클라이언트는 요청 라이브러리가 Content-Type의 boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

image*file

변형의 기반 이미지입니다. 4 MB 미만의 정사각형 PNG를 사용하세요. 실제 파일 제한은 선택한 모델을 따릅니다.

형식binary

model?string

사용할 이미지 변형 모델 ID입니다. 현재 API 키에 표시되며 이미지 변형을 지원하는 모델을 선택하세요.

길이1 <= length

n?integer|null

반환할 이미지 변형 수이며 범위는 1~10입니다. 실제 지원 개수는 선택한 모델에 따라 다릅니다.

범위1 <= value <= 10

기본값1

response_format?string|null

이미지 응답 형식입니다. url은 생성 후 60분 동안 유효한 이미지 주소를 반환하고 b64_json은 Base64로 인코딩된 이미지 데이터를 반환합니다.

기본값"url"

허용 값

"url"
"b64_json"
null

size?string|null

이미지 크기이며 256x256, 512x512 및 1024x1024를 지원합니다.

기본값"1024x1024"

허용 값

"256x256"
"512x512"
"1024x1024"
null

user?string

최종 사용자를 나타내는 고유 식별자이며 모니터링 및 오용 감지에 사용할 수 있습니다.

길이1 <= length

응답 본문

`application/json`

curl -X POST "https://example.com/v1/images/variations" \
  -F image="otter.png" \
  -F model="MODEL_ID" \
  -F n="2" \
  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/image-variation-1.png"
    },
    {
      "url": "https://example.com/image-variation-2.png"
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

401application/json

`application/json`

`application/json`