Ideogram - Character
POST
/api/v1/jobs/createTask
Query Task Status
callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Related Resources
Request
Body Params application/jsonRequired
Responses
Request 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",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "Place the woman from the uploaded portrait, wearing a casual white blouse, in a peaceful garden setting. The scene should feature vibrant green plants and colorful flowers, with soft sunlight filtering through the leaves. She should be sitting on a wooden bench, holding a book and smiling gently. The background should be filled with lush greenery, with a serene, tranquil atmosphere. Golden afternoon light should highlight the woman’s face and create soft shadows on the ground, adding a peaceful, reflective mood to the scene",
"reference_image_urls": [
"https://file.aiquickdraw.com/custom-page/akr/section-images/1755767145415pvz49dpi.webp"
],
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": true,
"num_images": "1",
"image_size": "square_hd",
"negative_prompt": ""
}
}'Response Response Example
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_ideogram_1765179922911"
}
}