Text-to-Image
AI-generatedSummary
Generate one or more images from a text prompt using the GPT-image-1.5 model via the Kie.ai API, with configurable parameters for image aspect ratio, quality, background transparency, output format and compression, random seed, and asynchronous completion handling.
Inputs
- Prompt (required) — The textual description used to generate the image(s).
- Aspect Ratio — Select the aspect ratio of the generated image(s): 1:1, 2:3, or 3:2.
- Quality — Set the image generation quality level: Auto, High, Medium, or Low.
- Number of Images — Specify how many images to generate in one request (1 to 10).
- Background — Choose background transparency: Auto, Transparent, or Opaque.
- Output Format — Select the output image format: PNG, WebP, or JPEG.
- Output Compression — Set compression level (0-100) for WebP or JPEG formats.
- Seed — Provide a seed number for reproducible results; 0 means random seed.
- Reply URL — Optionally provide a webhook URL to receive a callback when image generation completes asynchronously.
- Reply Ref — A custom reference string sent back in the webhook callback to track the request.
- Wait for Completion — Whether to block execution until the image generation task completes (polls every 3 seconds, timeout after 5 minutes).
Output shape
a JSON array of result objects, each representing the API response for the image generation request
If 'Wait for Completion' is true, each output item includes parsed final task results with URLs to the generated images. If false, output includes initial API response with task ID for manual status polling. Errors can be returned inline if 'Continue On Fail' is enabled.
Examples
Example 1: Generate a single 3:2 aspect ratio PNG image with medium quality from the prompt "sunset over a mountain lake" and wait for completion.
Set Prompt to 'sunset over a mountain lake', Aspect Ratio to '3:2', Quality to 'medium', Number of Images to 1, Output Format to 'PNG', Wait for Completion to true.