> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Z Image Turbo Image Generation

This is an asynchronous API that only returns an async task\_id. You need to use the task\_id to call the task result query API to obtain the generated result.

<Tip>
  This is an **asynchronous** API and will only return the task\_id of the asynchronous task. You should use this task\_id to request the [Query Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated result.
</Tip>

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum value: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="mask" type="string">
  Mask image URL for inpainting. White areas are repainted, while black areas remain unchanged. Must be used together with image\_url
</ParamField>

<ParamField body="seed" type="integer" default={-1}>
  Random seed for generation. -1 means using a random seed. Range: -1 to 2147483647

  Value range: \[-1, 2147483647]
</ParamField>

<ParamField body="size" type="string" default="1024*1024">
  Pixel dimensions of the generated image (width\*height). Each dimension ranges from 256 to 1536 pixels
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Positive prompt for generation
</ParamField>

<ParamField body="strength" type="number">
  Transformation strength for img2img. 0.0-0.3 enhancement mode, 0.3-0.6 balanced transformation, 0.6-0.8 style conversion, 0.8-1.0 creative repainting. Must be used together with image\_url

  Value range: \[0, 1]
</ParamField>

<ParamField body="image_url" type="string">
  Reference image URL for img2img
</ParamField>

<ParamField body="output_format" type="string" default="webp">
  Format of the output image. Supports jpeg, png, webp

  Optional values: `jpeg`, `png`, `webp`
</ParamField>

<ParamField body="enable_base64_output" type="boolean" default={false}>
  If enabled, the output will be encoded as a BASE64 string instead of a URL. This property is only available via API
</ParamField>

## Response Information

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id to request the [Query Task Result API](/en/docs/models/reference-get-async-task-result) to retrieve the generated output.
</ResponseField>