Skip to main content
POST
Midjourney에는 콘텐츠 검토 시스템이 내장되어 있습니다. 생성된 이미지 중 일부가 검토에 의해 필터링된 경우, 해당 요청에서 소비된 크레딧은 환불되지 않습니다. 프롬프트가 콘텐츠 가이드라인을 준수하는지 확인해 주세요.

인증

Authorization
string
header
필수

##모든 인터페이스는 Bearer Token 인증이 필요합니다##

API Key 발급:

API Key 관리 페이지에서 API Key를 발급받으세요

요청 헤더에 다음을 추가하세요:

본문

application/json
model
enum<string>
기본값:mj-v7-variation
필수

모델 이름

사용 가능한 옵션:
mj-v7-variation
model_params
object
필수

모델 매개변수

prompt
string | null

선택적 프롬프트, 입력 시 remix 프롬프트로 사용되어 변형과 동시에 내용 수정

prompt는 선택 사항입니다. 생략, 빈 문자열, 공백만 있거나 제어 대상 속도·버전 매개변수를 제거한 뒤 비어 있으면 speed=turbo여도 Fast로 실행하고 Fast 요금을 적용합니다. 유효한 본문이 있으면 속도 생략 또는 fast는 Fast, turbo는 Turbo로 실행하며 Fast 요금의 2배입니다. Playground는 Fast만 제공합니다. 원본 작업은 현재 사용자의 완료된 작업이어야 합니다. prompt가 없을 때는 이미지 생성 및 지원되는 variation, pan, outpaint 결과를 사용할 수 있습니다.

예시:

"일몰 장면으로 변경"

callback_url
string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 시점:

  • 작업 완료(completed), 실패(failed) 또는 취소(cancelled) 시 트리거
  • 과금 확인 완료 후 전송

보안 제한:

  • HTTPS 프로토콜만 지원
  • 내부 네트워크 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
  • URL 길이 최대 2048자

콜백 메커니즘:

  • 타임아웃: 10초
  • 실패 후 최대 3회 재시도 (실패 후 1초/2초/4초에 각각 재시도)
  • 콜백 응답 형식은 작업 조회 인터페이스 반환 형식과 동일
  • 콜백 주소가 2xx 상태 코드를 반환하면 성공, 기타 상태 코드는 재시도 트리거
예시:

"https://your-domain.com/webhooks/image-task-completed"

응답

작업 생성 성공

created
integer

작업 생성 타임스탬프

예시:

1757165031

id
string

작업 ID

예시:

"task-unified-1757165031-mjv7"

model
string

실제 사용된 모델 이름

예시:

"mj-v7-variation"

object
enum<string>

작업 유형

사용 가능한 옵션:
image.generation.task
progress
integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100
예시:

0

status
enum<string>

작업 상태

사용 가능한 옵션:
pending,
processing,
completed,
failed
예시:

"pending"

task_info
object

비동기 작업 정보

type
enum<string>

작업 출력 유형

사용 가능한 옵션:
text,
image,
audio,
video
예시:

"image"

usage
object

사용량 및 과금 정보

effective_speed
enum<string>

prompt는 선택 사항입니다. 생략, 빈 문자열, 공백만 있거나 제어 대상 속도·버전 매개변수를 제거한 뒤 비어 있으면 speed=turbo여도 Fast로 실행하고 Fast 요금을 적용합니다. 유효한 본문이 있으면 속도 생략 또는 fast는 Fast, turbo는 Turbo로 실행하며 Fast 요금의 2배입니다. Playground는 Fast만 제공합니다. 원본 작업은 현재 사용자의 완료된 작업이어야 합니다. prompt가 없을 때는 이미지 생성 및 지원되는 variation, pan, outpaint 결과를 사용할 수 있습니다.

사용 가능한 옵션:
fast,
turbo