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

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

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

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Imagine 그리드(4분할)의 한 칸에 대해 약한 변형(varySubtle, V1–V4에 해당)을 실행합니다. 강한 변형은 High Variation을 참고하세요.
항목내용
actionVARIATION
과금midjourney@variation[-speed]
필수task_id + index, 또는 task_id + custom_id
선택speed, metadata

​
파라미터

필드설명
task_id플랫폼에서 반환한 원본 작업 ID(SUCCESS여야 함)
index1–4 (V1–V4에 해당). custom_id와 둘 중 하나
custom_id해당 작업의 버튼 ID를 직접 지정하면 index 자동 매칭을 하지 않습니다
speedrelax / fast / turbo
metadata사용자 정의 메타데이터

​
요청 예시

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 3,
  "speed": "turbo"
}

​
응답

제출 시 새로운 로컬 task_id를 반환합니다. GET /v1/tasks/{task_id}를 폴링하면 SUCCESS 시 변형의 새 4분할 grid_image_url과 4장의 image_urls를 포함합니다: 
{
  "id": "task_xxx",
  "status": "SUCCESS",
  "action": "VARIATION",
  "grid_image_url": "...",
  "image_urls": ["...", "...", "...", "..."]
}
원본 작업의 version / niji가 자동으로 상속됩니다(과금 폴백에 영향). 속도별 과금을 구분하려면 midjourney@variation-fast / midjourney@variation-turbo를 설정할 수 있습니다.

​
참고

  • 부모 작업은 SUCCESS 상태여야 하며, 그렇지 않으면 400(task is not in SUCCESS state)을 반환합니다.
  • index는 1–4여야 합니다. custom_id와 index는 둘 중 하나입니다.
  • 기본은 varySubtle(약한 변형)이며, 강한 변형은 High Variation을, Low Variation은 동일 action에 과금 키만 다르고 동작은 동일합니다.