이미지 화질 개선

image-enhancer

Image Enhancer 기능을 Zavilo SDK에서 사용하는 방법입니다. 아래에서 입력 제한, 파라미터, 출력 형식과 지원 모드를 확인할 수 있습니다.

H · HeadlessI · InteractiveE · Embedded

도구 IDimage-enhancer

버전1

실행 방식CLIENT

지원 모드Headless, Interactive, Embedded

빠른 이동

입력 파일 1출력 파일 1

결과 처리 가이드 → 레시피 → 연동 예제 → 플레이그라운드 →

입력

이 Tool이 허용하는 입력 형식과 파일 개수입니다.

입력 종류	file
파일 수	1 – 1
허용 MIME 형식	image/jpeg, image/png, image/webp

파라미터

아래 값은 request.options에 전달합니다.

파라미터	타입	필수	기본값	허용값 / 범위	설명
`preset`	enum	선택	`balanced`	natural \| balanced \| vivid	처리에 사용할 프리셋을 선택합니다.
`auto`	boolean	선택	`true`	—	Analyze the image and use automatic correction as the base settings.
`brightness`	number	선택	—	-50 – 50	밝기를 조절합니다.
`contrast`	number	선택	—	-50 – 50	대비를 조절합니다.
`saturation`	number	선택	—	-50 – 50	채도를 조절합니다.
`temperature`	number	선택	—	-50 – 50	Color temperature adjustment.
`highlights`	number	선택	—	-50 – 50	Highlight adjustment.
`shadows`	number	선택	—	-50 – 50	Shadow adjustment.
`sharpness`	number	선택	—	0 – 60	Sharpness adjustment.
`denoise`	number	선택	—	0 – 60	Noise reduction amount.
`format`	enum	선택	`jpg`	jpg \| png \| webp	출력 파일 형식을 설정합니다.
`quality`	number	선택	`0.92`	0.6 – 1	출력 품질을 설정합니다.

출력

처리가 완료되면 반환되는 결과 형식입니다.

출력 종류	files
파일 수	1 – 1
출력 MIME	image/jpeg, image/png, image/webp
Metadata	inputBytes, outputBytes, preset, auto, brightness, contrast, saturation, temperature, highlights, shadows, sharpness, denoise
ZIP 묶음	미지원

기본 사용 예제

지원되는 연동 모드를 확인하고 생성된 시작 코드를 바로 복사할 수 있습니다.

Headless

const result = await client.run("image-enhancer", {
  file,
  options: { preset: "balanced", auto: true }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "image-enhancer",
  input: { file },
  options: { preset: "balanced", auto: true },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

await client.mount({ tool: "image-enhancer", target: "#zavilo-tool", mode: "embedded" });

이 명세는 실제 SDK 런타임이 사용하는 Tool Definition을 기준으로 자동 생성됩니다.