Z Image Turbo

Usage-based pricing
ae_z_image_turbo

Quickly generate up to four images from a text prompt, with customizable size and format.

Image
Usage-based pricing

Pricing

The charge per call is (max(6 × total generated image pixels (megapixels), 0)) AE credits. All applicable conditions are combined to calculate the total.

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.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.landscape_4_3
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

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_z_image_turbo' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "acceleration": "regular",
      "enable_prompt_expansion": false,
      "enable_safety_checker": false,
      "image_size": {
        "height": 1024,
        "width": 1024
      },
      "num_images": 1,
      "num_inference_steps": 8,
      "output_format": "png",
      "prompt": "扁平矢量插画,大块几何纯色,无描边,无轮廓线,无黑边,无渐变网格,无噪点,颜色鲜明饱和(金黄 #FFD34D、天蓝 #4FA8FF、薄荷绿 #46D3A4、珊瑚橙 #FF7A59、奶油白 #FFFBF0)。主体:一只坐着的胖兔子,薄荷绿色身体,粉色长耳朵内侧,奶油白色肚皮,小圆尾巴。画面里只有这一个主体,居中,占画面约八成。纯白色背景,背景必须完全空白:不要背景色块、不要圆角方形底、不要场景、不要地面、不要白边贴纸、无文字、无边框、无投影。"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "b9390277-2cec-4a52-bd09-9fb4c140a9af"
}