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

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

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

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
부모 작업의 4분할(grid_image_url)에서 U1–U4 중 한 장을 선택해 단일 이미지를 얻습니다. 기존 4장에서 잘라내는 방식으로 구현되어 로컬 합성으로 보통 즉시 반환됩니다.
항목내용
actionUPSCALE
과금midjourney@upscale[-version][-speed]
필수task_id + index, 또는 task_id + custom_id
선택speed, metadata

​
파라미터

필드타입설명
task_idstring부모 작업 ID(imagine / variation / reroll 등의 SUCCESS 작업이어야 함)
indexint몇 번째 이미지(U1–U4), 범위 1–4. custom_id와 둘 중 하나
custom_idstring해당 작업의 버튼 ID를 직접 전달. index와 둘 중 하나. 지정 시 index 매칭을 건너뜀
speedstringrelax / fast / turbo(로컬 합성이므로 영향 없음)
metadataobject사용자 정의 메타데이터

​
요청 예시

index로 선택: 
{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 1,
  "speed": "fast"
}
버튼을 직접 전달: 
{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample::1::xxxx"
}

​
응답

제출 시 새 task_id를 반환하며 보통 밀리초 내에 SUCCESS가 됩니다. SUCCESS 시 image_urls는 1개 요소(단일 이미지)이고 buttons에는 후속 작업(zoom / inpaint / pan / variation 등)이 포함됩니다.

​
참고

  • 부모 작업은 SUCCESS 상태여야 하며, 그렇지 않으면 400(task is not in SUCCESS state)을 반환합니다.
  • index는 1–4여야 하며 범위를 벗어나면 400. custom_id와 index는 둘 중 하나이며 둘 다 전달하면 custom_id가 우선합니다.
  • 리소스를 소비하는 단계는 imagine이며, upscale은 기존 이미지에서 고르기만 하므로 거의 실패하지 않습니다.
  • upscale 후 단일 이미지는 Zoom / Inpaint / Variation으로 이어갈 수 있습니다.

​
HD upscale(고화질 업스케일, 2x 단일 이미지 출력)

일반 upscale은 로컬 합성입니다——부모 작업에 이미 존재하는 4장 중 한 장을 잘라내어 즉시 반환합니다. 이후 단일 이미지에 zoom / inpaint 등의 정밀 작업을 하려면 HD upscale 사용을 권장합니다: 실제 확대를 수행하여 2x 고화질 단일 이미지를 출력하며, 약 60–120초에 완료되고, 생성된 단일 이미지는 후속 zoom / inpaint를 더 안정적으로 지원합니다. HD upscale은 custom_id로 확대 명령을 지정하며, imagine 버전마다 서로 다른 명령에 대응합니다:
customId 명령적용 버전
upsample_v5_2xv5 imagine
upsample_v5_4xv5 imagine
upsample_v6_2x_subtlev6 / v6.1 imagine
upsample_v6_2x_creativev6 / v6.1 imagine
upsample_v7_2x_subtlev7 / v8.1 imagine
upsample_v7_2x_creativev7 / v8.1 imagine

​
HD upscale 예시

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample_v7_2x_subtle::1::xxxx"
}
완료되면 진짜 2x 고화질 단일 이미지 작업을 얻게 되며, 계속해서 zoom / inpaint를 수행할 수 있습니다.

​
일반 upscale과의 비교

항목일반 upscaleHD upscale
구현로컬 합성(잘라내기)실제 확대 처리
소요 시간밀리초 수준약 60–120초
출력4장 중 N번째 선택2x 고화질 단일 이미지
후속zoom / inpaint / variationzoom / inpaint 더 안정적

​
⚠️ pan은 여전히 사용 불가

HD upscale로 생성한 고화질 단일 이미지라도 pan 작업은 여전히 거부됩니다(“무효한 생성 요청” 반환)——이는 Midjourney가 pan 작업 자체에 두는 제한이며, 확대 방식과는 무관합니다. 자세한 내용은 Pan을 참조하세요.