메인 콘텐츠로 건너뛰기
POST
/
v1
/
midjourney
/
generations
/
zoom
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/zoom \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "zoom_ratio": 1.5,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/zoom \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "zoom_ratio": 1.5,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Upscale 이후 단일 이미지에 대해 Zoom Out(아웃페인트)을 실행합니다. 원본 이미지는 유지되고 바깥쪽으로 배경이 채워집니다. zoom_ratio < 2는 Outpaint(1.5×), ≥ 2 또는 미지정은 CustomZoom(2×)이며 둘 다 바로 이미지를 생성합니다.
항목내용
actionZOOM
과금midjourney@zoom[-speed]
필수task_id, 또는 task_id + custom_id
선택zoom_ratio, index, speed, metadata

​
파라미터

필드설명
task_id플랫폼에서 반환한 작업 ID (Upscale 이후 단일 이미지 작업이어야 함)
custom_id선택. Zoom에 해당하는 작업의 버튼 ID를 직접 지정
index선택. 부모 작업의 몇 번째 이미지인지(1–4, 기본 1). 단일 이미지에서는 보통 불필요
zoom_ratio선택. 자동 매칭되는 Zoom Out 단계 (아래 표)
speedrelax / fast / turbo
metadata선택, 사용자 정의 메타데이터

​
자동 매칭

zoom_ratio매칭 버튼
2 미만Zoom Out 1.5x
생략 또는 >= 2Zoom Out 2x

​
요청 예시

{
  "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
  "zoom_ratio": 1.5,
  "speed": "fast"
}

​
주의

  • 부모 작업은 Upscale 이후 단일 이미지이고 SUCCESS여야 합니다. 그리드를 넘기면 This action requires an upscaled task...를 반환하므로 먼저 upscale을 호출하세요.
  • Outpaint / CustomZoom 모두 바로 이미지를 생성하며 mask가 필요 없고 MODAL에 진입하지 않습니다(MODAL은 Inpaint만 사용).
  • 원본 작업의 버전 metadata가 자동으로 상속됩니다. 속도별 과금을 구분하려면 midjourney@zoom-fast / midjourney@zoom-turbo를 설정할 수 있습니다.

​
응답

성공 시 새로운 로컬 task_id가 반환됩니다. 결과는 GET /v1/tasks/{task_id}를 폴링해 확인하세요.