이미지 편집

POST/v1/images/edits

참조 이미지를 업로드하고 프롬프트에 따라 편집합니다.

인증

bearerAuth

인증Bearer <token>

플랫폼 API Key를 Authorization: Bearer your-api-key 형식으로 사용하세요.

전달 위치: header

요청 본문

multipart/form-data

TypeScript 타입 정의

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

model*string

플랫폼 모델 ID.

prompt*string

이미지 편집 지시. 프롬프트 보강은 항상 켜집니다. 앞뒤 공백을 제외한 Unicode 문자 수로 계산하며 공백만 입력할 수 없습니다.

길이1 <= length <= 32000

n?integer

생성할 이미지 수.

범위1 <= value <= 10

기본값1

size?string

auto 또는 WIDTHxHEIGHT, 기본값은 auto입니다. 사용자 지정 면적은 655,360–20,000,000픽셀, 가로세로 비율은 1:3–3:1입니다. 너비와 높이를 지정할 때 aspect_ratio와 area를 생략하세요.

기본값"auto"

aspect_ratio?string

기본값은 auto이며 보강된 프롬프트와 편집 시 참조 이미지로 결정합니다. X:Y도 가능하며 X와 Y는 1–300의 정수, 비율은 1:3–3:1입니다. size가 생략되거나 auto일 때만 사용합니다.

area?string

면적 단계, 기본값은 4K입니다. size가 생략되거나 auto일 때만 사용하며 실제 크기는 data[].size에 반환됩니다.

허용 값

"1K"
"2K"
"4K"

output_format?string

이미지 형식. jpg와 jpeg는 동일하며 응답은 jpeg를 사용합니다.

기본값"jpeg"

허용 값

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url 링크 유효 기간은 24시간입니다. b64_json은 Base64를 반환하며 스트리밍을 지원하지 않습니다. Base64 총 출력 면적은 PNG 20,000,000픽셀, JPEG/WebP 80,000,000픽셀이며 모든 이미지를 합산합니다.

기본값"url"

허용 값

"url"
"b64_json"

output_compression?integer

JPEG/WebP 압축 품질. 값이 높을수록 파일이 커집니다. PNG에서는 무시합니다.

범위0 <= value <= 100

기본값95

stream?boolean

SSE로 이미지별 결과를 반환할지 여부. response_format이 url인 경우만 지원합니다.

기본값false

aigc_watermark?boolean

표시되는 AIGC 워터마크를 추가할지 여부. 파일 메타데이터의 비가시적 식별자에는 영향을 주지 않습니다.

기본값false

image*array<>

참조 이미지 1–16장. JPG, JPEG, PNG, WEBP, HEIC, HEIF를 지원합니다. 각 이미지와 전체 요청 본문은 각각 64 MiB 이하, 변 길이는 128–8192픽셀, 긴 변/짧은 변 비율은 4:1 이하입니다. Base64 인코딩 크기도 본문 크기에 포함됩니다. 파일마다 image 필드를 사용하며 여러 파일은 image[]도 가능합니다. 업로드 순서가 이미지 번호입니다.

항목1 <= items <= 16

JSON 이미지 참조

JSON 요청은 images 객체 배열로 참조 이미지를 전송하며 나머지 필드는 파일 업로드 방식과 같습니다.

필드 JSON 표현

필드	JSON 표현
`images[].image_url`	필수입니다. 공개 URL, Base64 Data URL 또는 mm_file://{file_id}를 지원합니다. 예시 URL은 생성 후 저장한 이미지 주소로 바꾸세요. 필수입니다. 공개 URL, Base64 Data URL 또는 mm_file://{file_id}를 지원합니다. 예시 URL은 생성 후 저장한 이미지 주소로 바꾸세요.

images[].image_url

필수입니다. 공개 URL, Base64 Data URL 또는 mm_file://{file_id}를 지원합니다. 예시 URL은 생성 후 저장한 이미지 주소로 바꾸세요.

응답 본문

`application/json`

type*string

created?integer

이벤트의 Unix 타임스탬프.

model?string

실제로 사용한 모델 ID.

image_index*integer

0부터 시작하는 이미지 인덱스.

범위0 <= value

url*string

생성 이미지의 임시 링크.

size?string

실제 이미지 WIDTHxHEIGHT.

output_format?string

실제 출력 형식.

허용 값

"jpeg"
"png"
"webp"

revised_prompt?string

해당 이미지에 사용한 프롬프트.

curl -X POST "https://api.agtcloud.ai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="탁상등의 녹색 갓을 아이보리색으로 바꾸고 나무 테이블, 배경, 조명과 구도를 유지해 주세요." \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "밝은 벽 앞 나무 테이블에 녹색 탁상등이 놓여 있고 부드러운 자연광이 갓과 테이블을 비춥니다."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

클라이언트 시간 제한은 600초 이상을 권장합니다. 시간 초과 또는 연결 종료 후에도 서버에서 생성이 계속될 수 있으며 다시 전송하면 새 요청이 생성됩니다.

MiniMax 이미지 편집 API요청 매개변수와 응답 구조를 확인합니다.

인증

요청 본문

JSON 이미지 참조

응답 본문

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

스트리밍 응답 이벤트

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`