Ideogram V3 Text to Image
POST
/api/v1/jobs/createTask
Create Task
Get Task Details
After submission, use the unified query endpoint to check task progress and retrieve resultscallBackUrl parameter so your service can receive completion notifications instead of polling for task status.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/v3-text-to-image",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A cinematic photograph of a tranquil lakeside at twilight, viewed from a slight elevation. In the center, a cluster of softly glowing reeds and water lilies emit a gentle golden light, their reflections shimmering on the calm surface. The elegant neon-style white text '\''Kie.ai'\'' hovers just above the water, subtly illuminated and harmonizing with the natural glow. Surrounding willows and drifting mist frame the scene, creating a serene yet magical atmosphere, with warm highlights contrasting against the cool blues of the evening sky.",
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": true,
"image_size": "square_hd",
"seed": 123456,
"negative_prompt": "blurry, low detail, distorted anatomy, extra limbs, malformed text, watermark"
}
}'Response Response Example
200 - 成功示例
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_ideogram_1765180586443"
}
}