Ideogram (Kie.ai) icon

Ideogram (Kie.ai)

Generate images using Ideogram via Kie.ai API

Actions8

Character Edit

AI-generated

Summary

Edit an existing character image by providing a prompt, the character's reference image(s), and a mask image URL to specify areas for inpainting. This operation sends parameters to Kie.ai's character-editing API and returns the edited image result, optionally waiting for the task completion or receiving webhook callbacks.

Inputs

  • Prompt (required) — Text description guiding the character image edit.
  • Image URL (required) — URL of the source image to be edited.
  • Reference Images (required) — One or more reference image URLs for character consistency (only one used by API currently).
  • Mask URL (required) — URL of the mask image for inpainting that matches the dimensions of the Image URL.
  • Rendering Speed — Trade-off setting between rendering speed and quality (Auto, Turbo, Default, Balanced, Quality).
  • Character ID — Optional identifier for the character to edit.
  • Reply URL — Webhook URL to notify when task completes.
  • Reply Ref — Custom reference string returned in the webhook callback.
  • Wait for Completion — Boolean indicating whether to wait and poll until the editing task completes before continuing.

Output shape

a JSON object containing the task response or the final edited image data if waited for completion

If 'Wait for Completion' is true, the operation polls the task status every 3 seconds (up to 5 minutes) and returns the completed edit's data. Otherwise, it returns the initial task response immediately. The output includes parsed result URLs for access to generated images.

Links

Discussion