메인 콘텐츠로 건너뛰기
POST
/
v1
/
midjourney
/
generations
/
low-variation
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/low-variation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "index": 1,
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/low-variation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
    "index": 1,
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Upscale 이후 단일 이미지에 대한 약한 변형(varySubtle, Variation과 완전히 동일하게 동작)입니다. 별도 엔드포인트는 주로 명명 일관성(High Variation과의 짝)과 가격 독립 설정을 위한 것이며, 신규 연동은 Variation을 직접 사용하길 권장합니다.
항목내용
actionLOW_VARIATION
과금midjourney@low_variation[-speed]
필수task_id + index, 또는 task_id + custom_id
선택speed, metadata

파라미터

필드설명
task_id플랫폼에서 반환한 작업 ID (보통 Upscale 이후 단일 이미지 작업)
index14; custom_id를 생략할 때 필수. 버튼 매칭에는 index를 사용하지 않습니다
custom_id해당 작업의 버튼 ID를 직접 지정하면 index 자동 매칭을 하지 않습니다
speedrelax / fast / turbo
metadata선택, 사용자 정의 메타데이터

자동 매칭

Vary (Subtle)을 우선하고, 실패 시 Make Variations로 폴백합니다.

요청 예시

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

주의

  • 보통 Imagine 그리드에 먼저 upscale을 호출한 뒤, Upscale이 반환한 새 task_id로 본 엔드포인트를 호출합니다.
  • 현재 구현에서는 custom_id를 생략해도 index가 필수입니다(버튼 매칭 로직 자체는 index를 쓰지 않습니다).
  • 원본 작업의 버전 metadata가 자동으로 상속됩니다. 속도별 과금을 구분하려면 midjourney@low_variation-fast / midjourney@low_variation-turbo를 설정할 수 있습니다.

응답

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