← Imagefactory

API 개발자 가이드

Imagefactory API로 배너 생성과 리사이즈를 자동화하세요. 서버·스크립트·CI/CD 파이프라인에서 호출할 수 있어요

API Key 발급하기

인증

모든 API 요청에 Authorization 헤더를 넣어야 해요

인증 헤더 형식

Authorization: Bearer <token>:<secret>

API Key 발급: 마이페이지 > API Keys에서 만들 수 있어요. Secret은 만들 때만 볼 수 있으니 꼭 저장해 두세요

curl -X POST https://www.imagefactory.co.kr/api/banner/resize-image \
  -H "Authorization: Bearer imf_xxx:your_secret" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl": "...", "originalWidth": 1200, "originalHeight": 630, "targetSizes": [...]}'

API 엔드포인트

추가 기능 — 요청 시 지원

도입이나 대량 사용 시 아래 기능도 외부 API로 제공할 수 있어요. 일반 사용자는 배너 워크스페이스에서 바로 쓸 수 있어요

  • •상품 배너 자동 생성 — AI 가 상품 이미지·카피로 14개 비율 배너 동시 생성
  • •극비율 배너 — 가로 8:1 같은 특수 비율 배너 (이벤트 페이지 헤더 등)
  • •카카오 비즈보드 합성 — 1029×258 비즈보드 전용 템플릿 자동 합성
  • •상세페이지 → 배너 자동화 — 상세페이지 스크린샷 1-5장으로 다비율 배너 자동 생성

API 사용 문의: sales@imagefactory.co.kr

사용량 API (v1)

팀의 포인트 사용 내역을 조회하는 read-only API예요. 자체 BI·회계·리포팅 시스템에 붙일 수 있도록 raw 데이터를 행 단위로 줘요

Swagger UI 열기OpenAPI 3.0 스펙 (JSON)
OpenAPI 3.0 표준을 따라요. Swagger Editor·Postman 같은 도구로 import 하거나, LLM에 붙여넣어 클라이언트 코드를 만들 수 있어요

엔드포인트

  • GET /api/v1/usage/summary
  • GET /api/v1/usage/timeseries
  • GET /api/v1/usage/by-designer
  • GET /api/v1/usage/by-folder
  • GET /api/v1/usage/by-subteam

에러 처리

HTTP 상태에러 코드설명
401AUTH_REQUIREDAuthorization 헤더 누락
401INVALID_TOKEN잘못된 API Key
400INSUFFICIENT_POINTS포인트 부족
400PROMPT_TOO_SHORT프롬프트 3자 미만
500-서버 오류
{
  "success": false,
  "errorCode": "INSUFFICIENT_POINTS",
  "error": "포인트가 모자라요. 필요: 100pt, 현재: 50pt"
}

요금

API포인트
상품 배너 생성100P / 장
극비율 배너 생성100P / 장
배너 리사이즈100P / 사이즈

웹 UI와 동일한 포인트가 차감됩니다. 포인트 충전하기