Skip to main content
GET
일반 폴링에는 통합 작업 API를 권장합니다.
통합 작업 상태는 pending / processing / completed / failed입니다. 성공 결과는 result.images[].url에 반환됩니다. 후속 작업용 buttons[].customId가 필요하면 MJ 형식 조회를 사용하세요.

상태 흐름

응답 예

grid_image_url는 2x2 그리드 이미지이고, image_urls는 잘라낸 4장의 단일 이미지 URL입니다.
필드 차이 안내
  • /v1/tasks/{task_id}는 통합 pending / processing / completed / failed 상태를 반환합니다.
  • /v1/midjourney/{task_id}grid_image_url, image_urls, buttons 같은 MJ 형식 필드를 반환합니다.
buttons 정보: 대부분의 후속 작업은 index, direction, zoom_ratio로 해당 customId를 자동 매핑합니다. 자동 매핑이 실패하면 custom_id를 직접 전달하세요.

상태 개요

조회 참고

  • 조회 엔드포인트는 별도로 과금되지 않습니다만, 빈도는 적절히(3~5s 폴링 권장).
  • 일반 사용자는 자신의 작업만 조회 가능하며, 타인 작업 조회 시 403을 반환합니다.
  • 작업은 기본 3일 보관되며 이후 조회는 404를 반환하지만, 생성된 이미지 / 동영상 URL은 계속 접근 가능합니다.

고급: custom_id 직접 전달

buttons[].customId를 읽은 뒤 후속 작업 엔드포인트의 custom_id 필드에 직접 전달하면 자동 매칭을 건너뜁니다: