Imagefactory Tasks API
The Tasks API from Imagefactory — 1 operation(s) for tasks.
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-tasks-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 Tasks 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: Tasks
paths:
/api/external/v1/tasks/{taskId}:
get:
tags:
- Tasks
summary: Get task status and images
parameters:
- name: taskId
in: path
required: true
schema:
type: string
responses:
'200':
description: Task belongs to this key and team
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: completed
kind: generate
count: 1
successCount: 1
failedCount: 0
pointsReserved: 100
pointsCharged: 100
pointsRefunded: 0
images:
- index: 0
url: https://example.com/output.png
width: 1024
height: 1024
'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
'404':
description: Not found or not owned by this key
'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: getApiExternalV1TasksByTaskId
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.