Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
Generate content using gpt-image/1.5-image-to-image
curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image/1.5-image-to-image",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "input_urls": [
      "https://static.aiquickdraw.com/tools/example/1765962794374_GhtqB9oX.webp"
    ],
    "prompt": "Edit the image to dress the woman using the provided clothing images. Preserve her exact likeness, expression, hairstyle, and proportions. Replace only the clothing, fitting the garments naturally to her existing pose and body geometry with realistic fabric behavior. Match lighting, shadows, and color temperature to the original photo so the outfit integrates photorealistically, without looking pasted on.",
    "aspect_ratio": "3:2",
    "quality": "medium"
  }
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_gpt-image_1765968156336"
  }
}

​
Overview

Generate images from input images using the GPT Image 1.5 Image To Image model. This model allows you to edit or modify existing images with text prompts. The process consists of two steps: create a generation task and query task status and results.

​
File Upload Requirements

Before using this API, you need to upload your image files:
1

Upload Image

Use the File Upload API to upload your source image.

File Upload API

Learn how to upload images and get file URLs
2

Get File URL

After upload, you’ll receive a file URL that you can use in the input_urls parameter.
  • Supported formats: JPEG, PNG, WebP
  • Maximum file size: 10MB
  • Maximum 16 input URLs per request
  • Images should be appropriate and follow usage guidelines

​
Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results
For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.

Market Overview

Explore all available models

Common API

Check credits and account usage

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json
​
model
enum<string>
default:gpt-image/1.5-image-to-image
required

The model name to use for generation. Required field.

  • Must be gpt-image/1.5-image-to-image for this endpoint
Available options:
gpt-image/1.5-image-to-image
Example:

"gpt-image/1.5-image-to-image"

​
callBackUrl
string<uri>

The URL to receive generation task completion updates. Optional but recommended for production use.

  • System will POST task status and results to this URL when generation completes
  • Callback includes generated content URLs and task information
  • Your callback endpoint should accept POST requests with JSON payload containing results
  • Alternatively, use the Get Task Details endpoint to poll task status
Example:

"https://your-domain.com/api/callback"

​
input
object

Input parameters for the generation task

Response

Request successful

​
code
enum<integer>

Response status code

  • 200: Success - Request has been processed successfully
  • 401: Unauthorized - Authentication credentials are missing or invalid
  • 402: Insufficient Credits - Account does not have enough credits to perform the operation
  • 404: Not Found - The requested resource or endpoint does not exist
  • 422: Validation Error - The request parameters failed validation checks
  • 429: Rate Limited - Request limit has been exceeded for this resource
  • 455: Service Unavailable - System is currently undergoing maintenance
  • 500: Server Error - An unexpected error occurred while processing the request
  • 501: Generation Failed - Content generation task failed
  • 505: Feature Disabled - The requested feature is currently disabled
Available options:
200,
401,
402,
404,
422,
429,
455,
500,
501,
505
​
msg
string

Response message, error description when failed

Example:

"success"

​
data
object