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.
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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.seed | integer | unknown | No | The same seed and the same prompt given to the same version of the model will output the same image every time. | — |
request_body.prompt | string | Yes | The prompt to generate an image from. | — |
request_body.strength | number | No | The strength of the inpaint conditioning. | 1 |
request_body.image_url | string | Yes | URL of Image for Inpaint generation. | — |
request_body.sync_mode | boolean | No | If `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_size | object | string | No | The size of the generated image. | auto |
request_body.image_size.width | integer | No | The width of the generated image. | 512 |
request_body.image_size.height | integer | No | The height of the generated image. | 512 |
request_body.num_images | integer | No | The number of images to generate. | 1 |
request_body.control_end | number | No | The end of the controlnet conditioning. | 0.8 |
request_body.acceleration | enum (none | regular | high) | No | The acceleration level to use. | regular |
request_body.control_scale | number | No | The scale of the controlnet conditioning. | 0.75 |
request_body.control_start | number | No | The start of the controlnet conditioning. | 0 |
request_body.output_format | enum (jpeg | png | webp) | No | The format of the generated image. | png |
request_body.mask_image_url | string | Yes | URL of Mask for Inpaint generation. | — |
request_body.num_inference_steps | integer | No | The number of inference steps to perform. | 8 |
request_body.enable_safety_checker | boolean | No | If set to true, the safety checker will be enabled. | true |
request_body.enable_prompt_expansion | boolean | No | Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request. | false |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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.







