Imagefactory Resize API
The Resize API from Imagefactory — 1 operation(s) for resize.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/imagefactory-co-kr:imagefactory-co-kr-resize-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Imagefactory External Resize API
version: 1.2.0
description: Team usage, resize, and image generation. Team integration keys are issued in My Page → API Keys. Approved team members can issue and use image keys; team-wide usage requires an admin or owner. Unapproved teams cannot issue image keys or submit new jobs. Removing team approval preserves accepted jobs and their settlement. Generate outputs are 1024×1024; use resize for exact dimensions. Reference instructions are optional per image. Pair mode requires count = reference count; roundrobin permits 1–5 outputs. Product images and design references have separate roles. Safe zones use output pixels from the top-left. Private input blobs are deleted on completion or timeout.
contact:
name: Imagefactory Support
url: https://www.imagefactory.co.kr
servers:
- url: https://www.imagefactory.co.kr
description: Production
security:
- bearerAuth: []
tags:
- name: Resize
paths:
/api/external/v1/images/resize:
post:
tags:
- Resize
summary: Resize with output dimensions, instructions and safe zones
description: 'Requires a team integration key with the matching permission. Reserves 100 points per output atomically; failures are refunded. Maximum 5 outputs, 2 active tasks per team. Poll the returned task ID. Source images: PNG/JPEG/WebP, 5 MB / 16 million pixels each. Total JSON body: 24 MB. Never retry with a new Idempotency-Key after a lost response.'
parameters:
- name: Idempotency-Key
in: header
required: true
schema:
type: string
minLength: 8
maxLength: 128
pattern: ^[a-zA-Z0-9_-]+$
example: example-request-001
requestBody:
required: true
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
image:
type: object
properties:
url:
type: string
maxLength: 2048
format: uri
base64:
type: string
minLength: 4
maxLength: 7000000
additionalProperties: false
originalWidth:
type: integer
exclusiveMinimum: 0
maximum: 16384
originalHeight:
type: integer
exclusiveMinimum: 0
maximum: 16384
instructions:
default: ''
type: string
maxLength: 6000
externalUserId:
type: string
pattern: ^[a-zA-Z0-9_.@-]{1,128}$
targetSizes:
minItems: 1
maxItems: 5
type: array
items:
type: object
properties:
width:
type: integer
minimum: 16
maximum: 4096
height:
type: integer
minimum: 16
maximum: 4096
instructions:
type: string
maxLength: 6000
safeZone:
type: object
properties:
x:
type: integer
minimum: 0
maximum: 9007199254740991
y:
type: integer
minimum: 0
maximum: 9007199254740991
width:
type: integer
minimum: 16
maximum: 9007199254740991
height:
type: integer
minimum: 16
maximum: 9007199254740991
required:
- x
- y
- width
- height
additionalProperties: false
required:
- width
- height
additionalProperties: false
required:
- image
- originalWidth
- originalHeight
- instructions
- targetSizes
additionalProperties: false
examples:
resize:
value:
image:
url: https://example.com/original.png
originalWidth: 1024
originalHeight: 1024
instructions: 제품과 로고를 유지해 주세요
targetSizes:
- width: 1200
height: 628
instructions: 문구는 왼쪽에 배치해 주세요
safeZone:
x: 60
y: 40
width: 1080
height: 548
responses:
'202':
description: Existing or newly queued task
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
success:
type: boolean
data:
type: object
properties:
taskId:
type: string
status:
type: string
enum:
- pending
- processing
- completed
- failed
kind:
type: string
enum:
- generate
- resize
count:
type: integer
minimum: 1
maximum: 5
successCount:
type: integer
minimum: 0
maximum: 9007199254740991
failedCount:
type: integer
minimum: 0
maximum: 9007199254740991
errorCode:
type: string
pointsReserved:
type: integer
minimum: 0
maximum: 9007199254740991
pointsCharged:
type: integer
minimum: 0
maximum: 9007199254740991
pointsRefunded:
type: integer
minimum: 0
maximum: 9007199254740991
images:
type: array
items:
type: object
properties:
index:
type: integer
minimum: 0
maximum: 9007199254740991
url:
type: string
format: uri
width:
type: integer
minimum: 0
maximum: 9007199254740991
height:
type: integer
minimum: 0
maximum: 9007199254740991
required:
- index
- url
- width
- height
additionalProperties: false
required:
- taskId
- status
- kind
- count
- successCount
- failedCount
- pointsReserved
- pointsCharged
- pointsRefunded
- images
additionalProperties: false
required:
- success
- data
additionalProperties: false
example:
success: true
data:
taskId: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
status: pending
kind: resize
count: 1
successCount: 0
failedCount: 0
pointsReserved: 100
pointsCharged: 100
pointsRefunded: 0
images: []
'400':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'401':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'402':
description: Insufficient team points. No job or debit created.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'403':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'409':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'413':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'429':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'500':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
'503':
description: Request rejected; inspect errorCode.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
const: false
errorCode:
type: string
requestId:
type: string
error:
type: object
properties:
code:
type: string
message:
type: string
operationId: postApiExternalV1ImagesResize
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: imf_<token>:<secret>
description: API keys are issued from the Imagefactory account dashboard (My Page → API Keys). Team owners and admins can issue integration keys with usage:read permission.