Z Image Turbo Image To Image

6.00 credits/MP
ae_z_image_turbo_image_to_image

Transform a source image into up to four new versions using a text prompt, with control over image size, edit strength, and output format.

Image
6.00 credits/MP

Pricing

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

6.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 image-to-image conditioning.0.6
request_body.image_urlstringYesURL of Image for Image-to-Image 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.accelerationenum (none | regular | high)NoThe acceleration level to use.regular
request_body.output_formatenum (jpeg | png | webp)NoThe format of the generated image.png
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_image_to_image' \
  --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/z-image-turbo-i2i-input.png"
    }
  }
}'

No response example available yet.