톡 스튜디오 · 브랜드메시지 이미지 업로드

브랜드메시지 이미지 업로드

브랜드메시지 발송에 사용할 이미지를 업로드하고 발송용 URL을 발급받는 API입니다. 브랜드메시지 이미지는 이 API로 업로드한 URL만 사용할 수 있습니다. multipart/form-data로 요청합니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

POST /talk/v1/brm/image

브랜드메시지 이미지 업로드

요청 파라미터

이름	타입	필수	기본값	조건	설명
`image_type`	string	필수	-	-	이미지 종류입니다. 발송 타입에 맞는 종류로 업로드해야 합니다. `default`—이미지형(BI) 이미지입니다. 권장 800x400, jpg/png 5MB 이하입니다. `wide`—와이드형(BW) 이미지입니다. 권장 800x600, jpg/png 5MB 이하입니다. `wide_list_first`—와이드리스트형(BL)의 대표(첫 번째) 이미지입니다. 비율 2:1을 권장합니다. `wide_list`—와이드리스트형(BL)의 항목 이미지입니다. 비율 1:1, 한 번에 최대 3개까지입니다. `carousel`—캐러셀형(BC)의 카드 이미지입니다. 한 번에 최대 10개까지입니다.
`images`	file	필수	-	multipart/form-data	업로드할 이미지 파일입니다. 단건 종류(default·wide·wide_list_first)는 1개, 다건 종류(wide_list·carousel)는 여러 개를 함께 보냅니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`urls`	array	업로드된 이미지 URL 목록입니다. 발송 API의 image_url·리스트·카드 이미지에 그대로 사용합니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "urls": [
    "https://recv.carrym.com/image/xxxx.jpg"
  ]
}