메인 콘텐츠로 건너뛰기
POST
/
v1
/
midjourney
/
generations
/
inpaint
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/inpaint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/inpaint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
영역 인페인트 진입점입니다(Vary (Region)에 해당). 제출 후 작업은 MODAL 상태가 됩니다. 완료하려면 mask + prompt를 지정해 modal을 호출해야 합니다.
항목내용
actionINPAINT
과금midjourney@inpaint[-version][-speed]
필수task_id, 또는 task_id + custom_id
선택index, speed, metadata

파라미터

필드설명
task_id원본 작업 ID (보통 Upscale 이후 단일 이미지 작업)
custom_id선택. Vary (Region)에 해당하는 작업의 버튼 ID를 직접 지정
index선택. 부모 작업의 몇 번째 이미지인지(14, 기본 1). 단일 이미지에서는 보통 불필요
speedrelax / fast / turbo
metadata선택

자동 매칭

서비스는 원본 작업의 buttons에서 Vary (Region)에 맞는 버튼을 찾습니다.

요청 예시

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

다음 단계

성공 시 응답은 status: "modal"을 반환합니다 — 이는 정상적인 비종료 상태이며 오류가 아닙니다. modal 엔드포인트로 이어가세요. task_id에는 inpaint가 반환한 로컬 작업 ID를 쓰고, **prompt**와 선택적으로 **mask_url**을 넘깁니다.
{
  "task_id": "task_03_inpaint...",
  "status": "modal",
  "model": "midjourney"
}

주의

  • 부모 작업은 SUCCESS인 Upscale 단일 이미지여야 합니다. 그리드를 직접 인페인트하면 오류가 나므로 먼저 upscale을 호출하세요.
  • MODAL 상태 진입 후 30분 이내에 modal을 호출해야 합니다. 그렇지 않으면 백엔드가 자동으로 취소 + 환불합니다.
  • 원본 작업의 버전 metadata가 자동으로 상속됩니다. 속도별 과금을 구분하려면 midjourney@inpaint-fast / midjourney@inpaint-turbo를 설정할 수 있습니다.