메인 콘텐츠로 건너뛰기
POST
/
v1
/
midjourney
/
generations
/
edits
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
    "image_urls": [
      "https://example.com/product.png"
    ],
    "version": "8.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
기존 이미지 + prompt로 이미지 전체를 다시 그립니다. 배경 교체, 스타일 전이, 내용 수정에 적합합니다.
항목내용
actionEDITS
과금midjourney@edits[-speed]
필수prompt + image_urls

​
파라미터

필드타입필수기본값설명
promptstring예—편집 지시
image_urlsstring[]예—편집 대상 이미지. 장당 ≤ 12 MiB
speedstring아니오relaxrelax / fast / turbo
metadataobject아니오—사용자 정의 메타데이터

​
구조화 필드 (선택)

Imagine과 동일. 본문 또는 prompt 안(예: --ar 16:9)에 지정할 수 있습니다. 본문 값이 우선하며 prompt 끝에 추가되고 직접 쓴 동일 플래그를 덮어씁니다.
필드타입MJ 대응설명
sizestring--ar종횡비. 예: "16:9", "1:1", "9:16"
qualitystring--q품질: "0.25", "0.5", "1", "2"
stylestring--style스타일: "raw" 등
versionstring--v버전. 주 버전은 --v <version>으로 추가됩니다. niji: true와 "7" / "6"을 함께 사용하면 Niji 버전으로 정규화됩니다
seedint--seed랜덤 시드
negative_promptstring--no네거티브 프롬프트. 예: "ugly, blurry"
stylizeint--s스타일 강도 (0–1000)
chaosint--c혼돈도 (0–100)
weirdint--w기괴도 (0–3000)
tilebool--tile타일 모드
nijibool--nijiNiji 스위치. niji: true + version: "7" / "6" 권장
iwfloat--iw이미지 가중치 (0–3). 참조 이미지 사용 시
cwint--cw캐릭터 가중치 (0–100)
swint--sw스타일 가중치 (0–1000)
crefstring--cref캐릭터 참조 이미지 URL
srefstring--sref스타일 참조 이미지 URL
drefstring--dref깊이 참조 이미지 URL
dwfloat--dw깊이 가중치 (0–100)
repeatint--repeat반복 생성 횟수 (2–40)
rawbool--raw원본(Raw) 스타일 (v5.1+ 지원)
draftbool--draft드래프트 모드 (v7+ 지원)
hdbool--hdHD 모드 (v8 / v8.1 전용, version 미지정 시 서버가 --v 8.1 자동 추가)
stopint--stop조기 종료 (10–100, v5-6.1 / niji 5-6 전용)
extrastring임의 --xxx이스케이프 핸들. prompt 끝에 그대로 추가

​
요청 예시

{
  "prompt": "replace the background with a modern kitchen, keep the product unchanged --ar 1:1",
  "image_urls": ["https://example.com/product.png"],
  "version": "8.1",
  "speed": "fast"
}

​
응답

제출 시 task_id를 반환하며, SUCCESS 시 편집된 image_urls(1~4장일 수 있음)와 grid_image_url을 포함합니다.

​
참고

  • imagine 참조 이미지와의 차이: edits는 “이미지 전체를 다시 그리고”, imagine + 참조 이미지는 “스타일을 참조”합니다.
  • prompt 또는 image_urls가 없으면 400, 단일 이미지가 12 MiB를 초과하면 400을 반환합니다.