Midjourney
Inpaint (인페인트)
영역 인페인트 진입점(Vary (Region)에 해당). 제출 후 MODAL 상태가 되며, modal로 mask + prompt를 제출해야 완료
POST
Vary (Region)에 해당). 제출 후 작업은 MODAL 상태가 됩니다. 완료하려면 mask + prompt를 지정해 modal을 호출해야 합니다.
| 항목 | 내용 |
|---|---|
| action | INPAINT |
| 과금 | midjourney@inpaint[-version][-speed] |
| 필수 | task_id, 또는 task_id + custom_id |
| 선택 | index, speed, metadata |
파라미터
| 필드 | 설명 |
|---|---|
task_id | 원본 작업 ID (보통 Upscale 이후 단일 이미지 작업) |
custom_id | 선택. Vary (Region)에 해당하는 작업의 버튼 ID를 직접 지정 |
index | 선택. 부모 작업의 몇 번째 이미지인지(1–4, 기본 1). 단일 이미지에서는 보통 불필요 |
speed | relax / fast / turbo |
metadata | 선택 |
자동 매칭
서비스는 원본 작업의buttons에서 Vary (Region)에 맞는 버튼을 찾습니다.
요청 예시
다음 단계
성공 시 응답은status: "modal"을 반환합니다 — 이는 정상적인 비종료 상태이며 오류가 아닙니다. modal 엔드포인트로 이어가세요. task_id에는 inpaint가 반환한 로컬 작업 ID를 쓰고, **prompt**와 선택적으로 **mask_url**을 넘깁니다.
주의
- 부모 작업은 SUCCESS인 Upscale 단일 이미지여야 합니다. 그리드를 직접 인페인트하면 오류가 나므로 먼저
upscale을 호출하세요. - MODAL 상태 진입 후 30분 이내에 modal을 호출해야 합니다. 그렇지 않으면 백엔드가 자동으로 취소 + 환불합니다.
- 원본 작업의 버전 metadata가 자동으로 상속됩니다. 속도별 과금을 구분하려면
midjourney@inpaint-fast/midjourney@inpaint-turbo를 설정할 수 있습니다.