Z Image Turbo Inpaint

12.00 credits/MP
ae_z_image_turbo_inpaint

Edit selected areas of an image using a mask and text instructions, with optional structural guidance for more precise results.

Image
12.00 credits/MP

Pricing

12.00 AE credits per MP. Charge for successfully returned images. Charge proportionally to actual pixels. One MP is 1,000,000 pixels.

12.00 credits/MP

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNo The same seed and the same prompt given to the same version of the model will output the same image every time. —
request_body.promptstringYesThe prompt to generate an image from.—
request_body.strengthnumberNoThe strength of the inpaint conditioning.1
request_body.image_urlstringYesURL of Image for Inpaint generation.—
request_body.sync_modebooleanNoIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.false
request_body.image_sizeobject | stringNoThe size of the generated image.auto
request_body.image_size.widthintegerNoThe width of the generated image.512
request_body.image_size.heightintegerNoThe height of the generated image.512
request_body.num_imagesintegerNoThe number of images to generate.1
request_body.control_endnumberNoThe end of the controlnet conditioning.0.8
request_body.accelerationenum (none | regular | high)NoThe acceleration level to use.regular
request_body.control_scalenumberNoThe scale of the controlnet conditioning.0.75
request_body.control_startnumberNoThe start of the controlnet conditioning.0
request_body.output_formatenum (jpeg | png | webp)NoThe format of the generated image.png
request_body.mask_image_urlstringYesURL of Mask for Inpaint generation.—
request_body.num_inference_stepsintegerNoThe number of inference steps to perform.8
request_body.enable_safety_checkerbooleanNoIf set to true, the safety checker will be enabled.true
request_body.enable_prompt_expansionbooleanNoWhether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request.false

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_z_image_turbo_inpaint' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "prompt": "A young Asian woman with long, vibrant purple hair stands on a sunlit sandy beach, posing confidently with her left hand resting on her hip. She gazes directly at the camera with a neutral expression. A sleek black ribbon bow is tied neatly on the right side of her head, just above her ear. She wears a flowing white cotton dress with a fitted bodice and a flared skirt that reaches mid-calf, slightly lifted by a gentle sea breeze. The beach behind her features fine, pale golden sand with subtle footprints, leading to calm turquoise waves under a clear blue sky with soft, wispy clouds. The lighting is natural daylight, casting soft shadows to her left, indicating late afternoon sun. The horizon line is visible in the background, with a faint silhouette of distant dunes. Her skin tone is fair with a natural glow, and her facial features are delicately defined. The composition is centered on her figure, framed from mid-thigh up, with shallow depth of field blurring the distant waves slightly.",
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/inpaint-input.jpg",
      "mask_image_url": "https://storage.googleapis.com/falserverless/whls/z-image-inpaint-mask.jpg"
    }
  }
}'

No response example available yet.