Ideogram - Character Edit

POST

/api/v1/jobs/createTask

Image generation by ideogram/character-edit

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request successful

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "ideogram/character-edit",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
        "prompt": "A fabulous look head tilted down, looking forward with a smile\n",
        "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/17557680349256sa0lk53.webp",
        "mask_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768046014ftgvma28.webp",
        "reference_image_urls": [
            "https://file.aiquickdraw.com/custom-page/akr/section-images/1755768064644jodsmfhq.webp"
        ],
        "rendering_speed": "BALANCED",
        "style": "AUTO",
        "expand_prompt": true,
        "num_images": "1"
    }
}'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "task_ideogram_1765179908063"
    }
}

Ideogram - V3 Reframe

Ideogram - Character Remix

Ideogram - Character Edit

Query Task Status#

Related Resources#

Request

Responses

Query Task Status

Related Resources