← ImagesFactory
API Developer Guide
Automate banner creation and resizing with the ImagesFactory API. Call programmatically from servers, scripts, and CI/CD pipelines.
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/product-banner/generate \
-H "Authorization: Bearer imf_xxx:your_secret" \
-H "Content-Type: application/json" \
-d '{"productImageUrl": "...", "headline": "...", ...}'API Endpoints
Error Handling
| HTTP Status | Error Code | Description |
|---|---|---|
| 401 | AUTH_REQUIRED | Authorization header missing |
| 401 | INVALID_TOKEN | Invalid API Key |
| 400 | INSUFFICIENT_POINTS | Insufficient points |
| 400 | PROMPT_TOO_SHORT | Prompt too short (min 3 chars) |
| 500 | - | Server error |
{
"success": false,
"errorCode": "INSUFFICIENT_POINTS",
"error": "포인트가 부족합니다. 필요: 100pt, 현재: 50pt"
}Pricing
| API | Points |
|---|---|
| Product Banner | 100P per image |
| Extreme Ratio Banner | 100P per image |
| Banner Resize | 100P per size |
| Background Image | 10P |
| Content Recommendation | 5P |
| Main Image | 10P |
Same points as the web UI are deducted. Charge points