Z-Image (Kie.ai) icon

Z-Image (Kie.ai)

Generate images using Z-Image via Kie.ai API

Actions2

Generate

AI-generated

Summary

Generate an image by providing a text prompt and optional parameters; optionally wait for the generation task to complete or receive a webhook callback upon completion.

Inputs

  • Prompt (required) — Text description guiding image generation.
  • Aspect Ratio — Select image aspect ratio: 1:1, 16:9, or 9:16. Default is 1:1.
  • Style — Optional style hint to influence image appearance.
  • Seed — Numeric seed for reproducibility; 0 selects a random seed.
  • Reply URL — Webhook URL to be called when the generation task completes.
  • Reply Ref — Custom reference string included in the webhook callback.
  • Wait for Completion — Boolean to determine if the node polls for task completion (default true, polling every 3 seconds up to 5 minutes).

Output shape

a list of JSON objects representing the task creation response or, if waiting is enabled, the final task result including generated image URLs and metadata.

If waiting for completion, the node polls the task status every 3 seconds and returns final result when done or fail. If not waiting, it returns immediately with task creation details. If a Reply URL is provided, the API will notify that URL upon task completion with the Reply Ref included if set.

Examples

Example 1: Generate a 1:1 aspect ratio image with a text prompt and wait for the result

Set 'Prompt' to your descriptive text and keep 'Wait for Completion' as true (default).

Example 2: Start image generation without waiting and receive results via webhook

Set 'Reply URL' to your webhook URL, 'Reply Ref' if needed, and set 'Wait for Completion' to false.

Links

Discussion