외부 연동 API
팀 사용량 조회, 리사이즈, 이미지 생성을 사내 서비스에 연결해요.
- 사용량 조회
팀의 차감·환불 거래를 기간별로 조회해요.
- 리사이즈
원본 이미지, 출력 크기, 자유 지시문, 세이프존을 받아요.
- 이미지 생성
프롬프트·카드·레퍼런스 세 방식으로 1~5장을 만들어요. 레퍼런스마다 참고 지시문을 넣을 수 있어요.
이미지 작업은 출력 장수 × 100pt를 먼저 차감하고 실패분을 환불해요. 팀 잔액이 부족하면 작업을 시작하지 않아요.
명세와 테스트 도구 열기인증
승인된 팀의 팀원은 생성·리사이즈 키를 만들 수 있어요. 팀 전체 사용량 조회는 관리자·소유자만 가능해요.
Authorization: Bearer <token>:<secret>
API 엔드포인트
GET /api/external/v1/usage/transactions?starting_at=2026-09-01T00:00:00Z&ending_at=2026-09-15T00:00:00Z
POST /api/external/v1/images/resize
POST /api/external/v1/images/generate
GET /api/external/v1/tasks/{taskId}
GET /api/external/v1/images/stylescurl -X POST https://www.imagefactory.co.kr/api/external/v1/images/generate \
-H 'Authorization: Bearer <token>:<secret>' \
-H 'Idempotency-Key: example-request-001' \
-H 'Content-Type: application/json' \
-d '{"mode":"prompt","prompt":"A product photograph in soft blue light","count":1}'