메인 콘텐츠로 건너뛰기
POST
/
v1
/
midjourney
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a beautiful sunset over mountains",
    "size": "16:9",
    "version": "6.1",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a beautiful sunset over mountains",
    "size": "16:9",
    "version": "6.1",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
기본 텍스트→이미지 / 참조 이미지 생성 엔드포인트이며 imagine과 동일합니다. 명시적 엔드포인트 /v1/midjourney/generations/imagine도 동일하게 동작합니다.
항목내용
actionIMAGINE
과금midjourney@imagine[-version][-speed]
필수prompt
선택image_urls, Prompt 파라미터, speed, metadata

​
요청 파라미터

필드타입필수설명
promptstring예프롬프트. MJ 네이티브 플래그 (예: --ar 16:9 --v 6.1) 지원
speedstring아니오속도 모드: relax(기본) / fast / turbo
image_urlsstring[]아니오참조 이미지 URL (image-to-image용). URL 또는 base64
metadataobject아니오작업과 함께 저장되는 사용자 정의 메타데이터. 비즈니스 추적에 사용 가능

​
구조화 필드 (선택)

JSON 본문 또는 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 끝에 그대로 추가

​
예시

방식 1: 모두 prompt에 작성 
{
  "prompt": "a beautiful sunset over mountains --ar 16:9 --v 6.1 --style raw --s 750"
}
방식 2: 구조화 본문 (권장) 
{
  "prompt": "a beautiful sunset over mountains",
  "size": "16:9",
  "version": "6.1",
  "style": "raw",
  "stylize": 750
}
주 버전과 Niji 버전 
{
  "prompt": "anime girl in a moonlit garden",
  "niji": true,
  "version": "7",
  "size": "9:16"
}
온라인 검증 완료 버전: 8.1, 7, 6.1, 5.2, 5.1, niji 7, niji 6. 주 버전은 body의 version을 사용하세요. Niji는 niji: true + version: "7" / "6"을 권장하며, 과금 버전은 niji7 / niji6으로 정규화됩니다.
방식 3: 혼합 (본문 우선) 
{
  "prompt": "a beautiful sunset --ar 1:1",
  "size": "16:9"
}
최종 prompt: a beautiful sunset --ar 16:9 (본문의 size가 prompt 내 --ar 1:1을 덮어씀)
이미지 참조 (image-to-image) 
{
  "prompt": "turn this product into a luxury studio photo",
  "image_urls": ["https://example.com/product.png"],
  "size": "1:1",
  "iw": 1.2
}
Fast 모드 
{
  "prompt": "a cute cat",
  "speed": "fast"
}
speed=relax 또는 speed 미전달 시 과금 speed 접미사가 추가되지 않습니다. fast / turbo는 해당 속도 채널로 적용되며 해당 과금 key와 매칭됩니다.

​
응답

{
  "code": 200,
  "data": [{
    "status": "submitted",
    "task_id": "task_01JWXXXXXXXXXXXX"
  }]
}
성공 후 작업 조회로 결과를 폴링하세요.