소재 등록 시 이미지 에러 문의

카카오모먼트 API에 대한 최신 공지는 카카오모먼트 공지사항카카오광고 통합 에이전시 에서 확인 가능합니다.

카카오모먼트 API 외 문의사항은 DevTalk 각 카테고리나 FAQ에서 확인 가능합니다. 카카오모먼트 오픈API 외 자주 발생하는 문의는 아래 게시판에서 확인 및 등록 가능합니다.

︎- AdFit SDK FAQ
︎- AdFit SDK 고객센터 문의
︎- 픽셀&SDK FAQ 1
︎- 픽셀&SDK 고객센터 문의

카카오모먼트 오픈API 권한이 없는 앱, 카카오모먼트 오픈API가 아닌 다른 문의의 경우 답변이 늦어지거나 진행이 불가하오니 이 점 양해 부탁드립니다.

※ 사용 중 문의사항은 아래 내용을 기재하신 후 작성해주시길 바랍니다.
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.

    • 사업자명:에코마케팅

    • APP 이름(ID):236159

    • 문의 내용:소재 등록시 전달한 이미지 URL이 유효하지 않거나 잘못된 이미지 형식입니다. 라는 에러 발생합니다.

실제로는 문제없는 이미지라서 어떤게 문제일지 확인 요청드리려고 합니다.

[요청]

2026-08-13 18:07:02,183 INFO [ForkPoolWorker-1] [models.py:174] - 카카오 소재 생성 API 요청. method=POST url=https://apis.moment.kakao.com/openapi/v4/creatives headers={‘User-Agent’: ‘python-requests/2.34.2’, ‘Accept-Encoding’: ‘gzip, deflate, br, zstd’, ‘Accept’: ‘/’, ‘Connection’: ‘keep-alive’, ‘adAccountId’: ‘252997’, ‘Authorization’: ‘***’, ‘Content-Length’: ‘1219’, ‘Content-Type’: ‘application/json’} payload={“adGroupId”: 4546761, “format”: “IMAGE_BANNER”, “imageFileUrl”: “https://s3-echo-data-store-dev.s3.ap-northeast-2.amazonaws.com/service=kbs_v2/image/260814_NB_SA_\uc561\ud2f0\ube0c\ub370\uc774\uc9882608^24H^\ub274\ubc1c\ub780\uc2a4.133313_BR_\uc561\ud2f0\ube0c_6353a00c-4cb2-4c82-9478-180519053a74.png”, “landingInfo”: null, “mobileLandingUrl”: “https://abr.ge/@wconcept/kakao?ad_creative=260814_NB_SA_액티브데이즈2608^24H^뉴발란스.133313_BR_액티브&ad_creative_id={creative_id}&ad_group=F2059_NF.retention_SA24h&ad_group_id={ad_group_id}&campaign=E_kakao_DA_AL_ALL_이탈_APP_비즈보드_PC_배너&campaign_id={campaign_id}&click_id={click_id}&gaid_raw={google_aid}&ifa_raw={apple_ifa}&routing_short_id=ell9ig&sub1={ad_service_id}&sub2={mbrseq}&sub_id={placement_id}&tracking_template_id=0d7554d7ca273672b9f7d7b186d82eab&ad_type=click”, “altText”: “W\ucee8\uc149 \uc561\ud2f0\ube0c\ub370\uc774\uc988”, “name”: “260814_NB_SA_\uc561\ud2f0\ube0c\ub370\uc774\uc9882608^24H^\ub274\ubc1c\ub780\uc2a4.133313_BR_\uc561\ud2f0\ube0c”, “opinion”: null, “opinionProofFileUrlList”: null}

[응답]

2026-08-13 18:07:02,183 INFO [ForkPoolWorker-1] [models.py:181] - 카카오 소재 생성 API 응답. status=400 body={“msg”:“KakaoMomentException”,“code”:-813,“extras”:{“detailCode”:75018,“detailMsg”:“전달한 이미지 URL이 유효하지 않거나 잘못된 이미지 형식입니다.”}}

안녕하세요. 카카오모먼트 담당자입니다.
확인 결과 요청 body의 imageFileUrl 값에 URL에 사용할 수 없는 특수문자 ^가 인코딩되지 않은 상태로 포함되어 있어 URL 검증 단계에서 차단되었습니다. 해당 문자를 URL 인코딩(percent-encoding)한 %5E로 치환하여 요청해 주셔야 합니다.

^ 외에도 URL에 그대로 사용할 수 없는 문자(` < > | 공백 등)가 있으므로, 특정 문자만 골라 치환하시기보다 URL path 전체에 URL 인코딩을 적용하시는 것을 권장드립니다. 감사합니다.