설명서Experience Cloud KCS

AEM Dynamic Media: 요청된 형식 대신 AVIF로 전달된 이미지

마지막 업데이트: 2026년 8월 15일

이 문서에서는 JPG 또는 다른 형식이 요청되어도 Adobe Experience Manager(AEM) Dynamic Media가 이미지를 AVIF 형식으로 전달하는 문제를 해결하는 방법에 대해 설명합니다.

설명 description

환경

  • Adobe Experience Manager(AEM) Dynamic Media(Open API)

증상

AEM Dynamic Media를 통해 에셋을 게시할 때 모든 이미지 파일은 원래 유형(예: JPG 또는 PNG)에 관계없이 AVIF 형식으로 제공됩니다. 이 문제는 다음과 같은 경우에도 발생합니다.

  • 파일 확장명은 AEM Dynamic Media 설정에서 JPG으로 설정됩니다.
  • fmt=jpg 매개 변수가 자산 배달 URL에 추가됩니다.

예를 들어 다음과 같은 URL:

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?fmt=jpg

를 사용하면 브라우저에서 저장할 때 파일이 AVIF로 전달됩니다. 이렇게 하면 AVIF를 지원하지 않는 이메일 생성 시스템과의 통합과 같이, JPG 형식의 이미지가 필요한 워크플로우를 차단할 수 있습니다.

원인

기본적으로 AEM Dynamic Media의 스마트 이미징 기능은 이미지를 AVIF 또는 WebP와 같은 최신 형식으로 자동 변환하여 게재를 최적화합니다. auto-format=false을(를) 설정하면 이 동작이 비활성화되고 요청된 이미지 형식이 유지됩니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. Dynamic Media 이미지에 사용된 에셋 게재 URL을 검토합니다.
  2. 자동 형식 변환을 무시하려면 매개 변수 auto-format=false을(를) 이미지 URL에 추가하십시오. 예:

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?auto-format=false

  1. 업데이트된 URL을 브라우저 또는 통합 워크플로우에서 액세스하여 테스트합니다. 이제 이미지가 AVIF 대신 요청된 형식(예: JPG)으로 전달되어야 합니다.
  2. 이메일 클라이언트 또는 외부 시스템에서 이미지를 사용하는 경우 파일이 올바른 형식으로 인식되는지 확인하십시오.
  3. 자세한 내용은 AEM Dynamic Media 에셋 배달 API 설명서를 참조하고 자동 형식 매개 변수를 검색하십시오.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles