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.
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.
| 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.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. | landscape_4_3 |
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.acceleration | enum (none | regular | high) | No | The acceleration level to use. | regular |
request_body.output_format | enum (jpeg | png | webp) | No | The format of the generated image. | png |
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
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeySubmit 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
{
"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"
}






