Ideogram (Kie.ai) icon

Ideogram (Kie.ai)

Generate images using Ideogram via Kie.ai API

Actions8

Generate (V3)

AI-generated

Summary

Generate images from a text prompt using the Ideogram V3 model via the Kie.ai API, optionally controlling style, aspect ratio, rendering speed, and output quantity.

Inputs

  • Prompt (required) — Text description guiding the image generation.
  • Rendering Speed — Optional trade-off setting between rendering speed and quality (Auto, Turbo, Default, Balanced, Quality).
  • Aspect Ratio — Image aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4). Defaults to 1:1.
  • Style — Optional style hint for image generation.
  • Negative Prompt — Elements or aspects to exclude from the generated image.
  • Style Type — Ideogram style type preset (Auto, General, Realistic, Design, Render 3D, Anime).
  • Magic Prompt Option — Enable or disable Ideogram Magic Prompt enhancement (Auto, On, Off).
  • Color Palette — Optional color palette preset name or hex color codes to influence colors.
  • Number of Images — Number of images to generate in one request (1 to 8). Defaults to 1.
  • Seed — Random seed for reproducibility; 0 indicates random seed.
  • Reply URL — Webhook URL to notify upon task completion.
  • Reply Ref — Custom string passed back in the webhook callback for reference.
  • Wait for Completion — Whether to wait for the generation task to complete before returning (polls every 3 seconds, times out after 5 minutes). Defaults to true.

Output shape

a JSON array where each element contains the API response for one image generation request; if waiting for completion, includes detailed task results with generated image URLs.

If 'Wait for Completion' is true, the node polls the task status every 3 seconds until success or failure, timing out after 5 minutes. Multiple images can be generated per request (up to 8). Responses include nested JSON fields parsed for easy access to image URLs.

Examples

Example 1: Generate a single high-quality 1024x1024 square image with a 'realistic' style of a mountain landscape using a specific seed.

Prompt set to 'mountain landscape', Style Type set to 'Realistic', Aspect Ratio 1:1, Number of Images 1, Seed set to a non-zero value, Rendering Speed to 'Quality', Wait for Completion true.

Links

Discussion