Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
Upscale Grok Imagine Images
curl --request POST \
  --url https://api.kie.ai/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine/upscale",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "task_id": "task_grok_12345678"
  }
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

​
Task ID Source

The task_id parameter should be obtained from a previously generated image task. You can upscale images that were created using:

Generate Images First

Create images using the text-to-image model to get a task ID for upscaling
How to get a task ID:
  1. Use the Text to Image API to generate images
  2. Extract the taskId from the API response
  3. Use that taskId as the task_id parameter in the upscale request
Only images generated by Kie AI models can be upscaled. External images are not supported.

​
Query Task Status

After submitting an upscale 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 upscaling 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:grok-imagine/upscale
required

The model name to use for generation. Required field.

  • Must be grok-imagine/upscale for this endpoint
Available options:
grok-imagine/upscale
Example:

"grok-imagine/upscale"

​
input
object
required

Input parameters for the image upscaling task

​
callBackUrl
string<uri>

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

  • System will POST task status and results to this URL when upscaling completes
  • Callback includes generated upscaled image URLs and task information
  • Your callback endpoint should accept POST requests with JSON payload containing image results
  • Alternatively, use the Get Task Details endpoint to poll task status
  • To ensure callback security, see Webhook Verification Guide for signature verification implementation
Example:

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

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 - Image upscaling 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