Upscale (Image Enhancement)

POST https://www.kkiai.com/ideogram/upscale

Official documentation: https://developer.ideogram.ai/api-reference/api-reference/upscale

Request Parameters

Header Parameters

Parameter	Type	Required	Description	Example
Accept	string	Required		application/json
Authorization	string	Required		Bearer {{YOUR_API_KEY}}
Content-Type	string	Optional		multipart/form-data

Body Parameters (multipart/form-data)

Parameter	Type	Required	Description
image_request	string	Optional	"prompt": "a beautiful sunset over mountains", // Prompt to guide upscaling (optional) "resemblance": 50, // Resemblance level (optional) Range: 1-100, default 50 "detail": 50, // Detail level (optional) Range: 1-100, default 50 "magic_prompt_option": "AUTO", // Whether to use MagicPrompt (optional) Options: AUTO/ON/OFF "num_images": 1, // Number of images to generate (optional) Range: 1-8, default 1 "seed": 123456 // Random seed (optional) Range: 0-2147483647
image_file	file	Optional	Image file (required) Source image file to upscale

cURL Example

curl --location --request POST 'https://www.kkiai.com/ideogram/upscale' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image_request="{
    \"resemblance\": 50,
    \"magic_prompt_option\": \"AUTO\",
    \"prompt\": \"A%20serene%20tropical%20beach%20\",
    \"seed\": 12345,
    \"detail\": 50
}"' \
--form 'image_file=@"C:\\Users\\Administrator\\Desktop\\example.png"'

Response

🟢 200 Success

Response Body

Parameter	Type	Required	Description
code	integer	Required
message	string	Required
request_id	string	Required
data	object	Required
└ task_id	string	Required
└ task_status	string	Required
└ created_at	integer	Required
└ updated_at	integer	Required

Response Example

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CjMT7WdSwWcAAAAAALvB3g",
    "data": {
        "task_id": "CjMT7WdSwWcAAAAAALvB3g",
        "task_status": "submitted",
        "created_at": 1733851336696,
        "updated_at": 1733851336696
    }
}