이미지 API: 압축, 크기 조정, 변환
파이프라인 호출 한 번으로 이미지 크기 조정, 자르기, 회전, 품질 또는 바이트 목표에 맞춘 압축, JPG, PNG, WebP, AVIF로의 변환을 처리합니다.
핵심 답변
sourceKey와, 최대 8개의 작업을 나열한 단계 {"operation":"image","pipeline":[…]}를 담아 POST /api/v1/pipeline/ 요청을 보냅니다. 작업은 resize(maxWidth, maxHeight), crop(x, y, width, height), rotate(degrees), compress(quality 1~100 또는 targetBytes), convert(jpg, png, webp, avif)입니다. 내 문서에 이미 있는 이미지는 {"operation":"image","pipeline":[…]}를 담아 /documents/{documentId}/process/ 를 사용하십시오.
웹용으로 압축하기
일반적인 제품 사진 파이프라인은 크기에 상한을 두고 WebP로 변환합니다. 자체 테스트에서 224 KB PNG가 약 4초 만에 너비 400 px, 30 KB WebP가 되었습니다.
curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'파일 크기 목표 맞추기
업로드 포털은 흔히 “200 KB 미만”을 요구합니다. 이때는 quality 대신 targetBytes를 지정해 compress를 사용하십시오. 워커가 목표 크기에 맞는 가장 높은 품질을 찾습니다. 목표 값은 API가 허용하는 최솟값과 최댓값(최대 20 MB) 사이여야 합니다.
{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }이미지 단계를 PDF 및 OCR과 연결하기
파이프라인은 이미지 단계 뒤에도 이어질 수 있습니다. {"operation":"convert","format":"pdf"}를 추가하면 결과를 PDF로 감싸고, {"operation":"ocr","format":"pdf"}를 추가하면 검색 가능하게 만듭니다. 다음 단계에 필요한 경우 이미지 단계는 자동으로 PNG를 출력합니다.
자주 묻는 질문
압축하면 메타데이터가 제거됩니까?
다시 인코딩한 이미지에는 GPS 위치 같은 EXIF 데이터가 남지 않습니다. 공개 이미지라면 보통 이렇게 되는 편이 바람직합니다.
어떤 형식을 선택해야 합니까?
웹사이트에는 WebP, 호환성이 가장 중요하면 JPG, 스크린샷과 선화에는 PNG, 사용자가 최신 브라우저를 쓰고 파일을 가장 작게 만들고 싶다면 AVIF를 사용하십시오.