Skip to main content
슈퍼해상도, 노이즈 제거, 색감 보정, 뷰티, 필터, 리사이즈, 블라인드 워터마크, 자동 지우기 등 이미지 처리 기능을 ImageTask 하위 설정으로 조합해 실행합니다. 콘솔 프리셋 오케스트레이션(AI 텍스트 워터마크 지우기, AI 전경 추출, AI 이미지 복원)은 ScheduleId만으로 호출합니다.

요청 방법

비동기 태스크입니다. 호출이 접수되면 TaskId가 즉시 발급되고, 처리 결과는 DescribeImageTaskDetail로 조회합니다. StatusFINISH이고 ErrMsg가 비어 있어야 성공입니다. 오케스트레이션 시나리오는 콘솔에 전체 파이프라인이 프리셋으로 정의되어 있어 입력 이미지와 ScheduleId만 전달합니다.

요청 파라미터

응답 파라미터

DescribeImageTaskDetail 조회 결과의 주요 필드는 다음과 같습니다.

호출 예시

응답 예시

ProcessImage 응답:
DescribeImageTaskDetail 조회 결과:

주의사항

SuperResolutionAdvancedSuperResolutionConfig는 상호 배타입니다. 단순 2배 업스케일은 SuperResolution, 3배 이상 또는 4K 목표 크기 지정은 AdvancedSuperResolutionConfig를 사용합니다.
ScheduleId 오케스트레이션(30000/30031/30040)은 콘솔 프리셋에 전체 파이프라인이 정의되어 있으므로 ImageTask의 개별 보정/지우기/뷰티 파라미터와 혼합하지 않습니다. 이 API에서 지원하는 오케스트레이션은 3개뿐이며, 누끼, 아웃페인팅, 배경 합성, 피팅 등은 각 기능의 전용 시나리오를 사용합니다.
블라인드 워터마크 텍스트는 UTF-8 기준 최대 4바이트입니다. 초과분은 잘립니다.
StatusFINISH여도 성공을 의미하지 않습니다. ErrMsg가 비어 있는지 반드시 함께 확인합니다.
EraseConfig는 이미지 전용입니다. 영상의 자막/워터마크 지우기는 별도의 영상 지우기 기능(SmartErase)을 사용합니다.
URL 입력은 공개 접근이 가능해야 하고, COS 입력은 MPS 서비스에 해당 Bucket의 읽기 권한이 있어야 합니다.
Last modified on August 16, 2026