← ImagesFactory

API Developer Guide

Automate banner creation and resizing with the ImagesFactory API. Call programmatically from servers, scripts, and CI/CD pipelines.

Get API Key

Authentication

All API requests must include an Authorization header.

Header Format

Authorization: Bearer <token>:<secret>

Get your API Key: Get your API Key from My Page > API Keys. The Secret is only shown once at creation — save it securely.

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 Endpoints

Additional Features — Available on Request

The following features can also be exposed as external APIs for enterprise / high-volume use. Regular users can use them directly in the workspace.

  • •Product Banner Generation — AI generates banners in 14 aspect ratios from product image + copy
  • •Extreme Aspect Banner — special ratios like 8:1 wide (event page headers, etc.)
  • •Kakao Bizboard Composition — automated template composition for 1029×258 bizboard
  • •Detail Page → Banner Automation — multi-ratio banners auto-generated from 1-5 detail page screenshots

API inquiries: sales@imagefactory.co.kr

Usage API (v1)

Read-only access to your team's point usage transactions. Returns raw transaction rows suitable for integration with BI dashboards, accounting, or reporting systems.

Open Swagger UIOpenAPI 3.0 spec (JSON)
OpenAPI 3.0 compliant. Import into Swagger Editor or Postman, or paste into an LLM to auto-generate client code.

Endpoints

  • 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

Error Handling

HTTP StatusError CodeDescription
401AUTH_REQUIREDAuthorization header missing
401INVALID_TOKENInvalid API Key
400INSUFFICIENT_POINTSInsufficient points
400PROMPT_TOO_SHORTPrompt too short (min 3 chars)
500-Server error
{
  "success": false,
  "errorCode": "INSUFFICIENT_POINTS",
  "error": "포인트가 부족합니다. 필요: 100pt, 현재: 50pt"
}

Pricing

APIPoints
Product Banner100P per image
Extreme Ratio Banner100P per image
Banner Resize100P per size
Background Image10P
Content Recommendation5P
Main Image10P

Same points as the web UI are deducted. Charge points