> ## Documentation Index
> Fetch the complete documentation index at: https://runpod-b18f5ded-docs-runpod-allow-ip.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If this page is missing information, contains outdated instructions, or doesn't fully answer the user's question, use the feedback tool to report it. In your feedback, be specific about what's missing, what appears out of date, or what needs to be corrected or updated, so the docs team can act on it directly.

# Z-Image Turbo

> A 6-billion-parameter image generation model with text-to-image and image-to-image support. See model inputs and outputs on Runpod Public Endpoints.

Z-Image Turbo is a powerful and highly efficient 6B parameter image generation model that supports both text-to-image and image-to-image generation. It delivers high-quality results with fast inference times.

<Card title="Try in playground" icon="play" href="https://console.runpod.io/hub/playground/image/z-image-turbo" horizontal>
  Test Z-Image Turbo in the Runpod Hub playground.
</Card>

|              |                                                  |
| ------------ | ------------------------------------------------ |
| **Endpoint** | `https://api.runpod.ai/v2/z-image-turbo/runsync` |
| **Pricing**  | \$0.005 per image                                |
| **Type**     | Image generation                                 |

## Request

All parameters are passed within the `input` object in the request body.

<ParamField body="input.prompt" type="string" required>
  Text description of the desired image. Supports English and Chinese.
</ParamField>

<ParamField body="input.image" type="string">
  URL of an input image for image-to-image generation.
</ParamField>

<ParamField body="input.size" type="string" default="1024*1024">
  Image dimensions. Options: `512*512`, `768*768`, `1024*1024`, `1280*1280`, `1024*768`, `768*1024`, `1280*720`, `720*1280`.
</ParamField>

<ParamField body="input.strength" type="number" default="0.8">
  Strength of modifications for image-to-image. Range: 0.0-1.0.
</ParamField>

<ParamField body="input.seed" type="integer" default="-1">
  Seed for reproducible results. Set to -1 for random.
</ParamField>

<ParamField body="input.output_format" type="string" default="png">
  Output format. Options: `png`, `jpeg`, `webp`.
</ParamField>

<ParamField body="input.enable_safety_checker" type="boolean" default="true">
  Enable content safety checking.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.runpod.ai/v2/z-image-turbo/runsync" \
    -H "Authorization: Bearer $RUNPOD_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "input": {
        "prompt": "A serene Japanese garden with cherry blossoms",
        "size": "1024*1024",
        "seed": -1,
        "output_format": "png",
        "enable_safety_checker": true
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.runpod.ai/v2/z-image-turbo/runsync",
      headers={
          "Authorization": f"Bearer {RUNPOD_API_KEY}",
          "Content-Type": "application/json",
      },
      json={
          "input": {
              "prompt": "A serene Japanese garden with cherry blossoms",
              "size": "1024*1024",
              "seed": -1,
              "output_format": "png",
              "enable_safety_checker": True,
          }
      },
  )

  result = response.json()
  print(result["output"]["image_url"])
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.runpod.ai/v2/z-image-turbo/runsync",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${RUNPOD_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        input: {
          prompt: "A serene Japanese garden with cherry blossoms",
          size: "1024*1024",
          seed: -1,
          output_format: "png",
          enable_safety_checker: true,
        },
      }),
    }
  );

  const result = await response.json();
  console.log(result.output.image_url);
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string">
  Unique identifier for the request.
</ResponseField>

<ResponseField name="status" type="string">
  Request status. Returns `COMPLETED` on success, `FAILED` on error.
</ResponseField>

<ResponseField name="delayTime" type="integer">
  Time in milliseconds the request spent in queue before processing began.
</ResponseField>

<ResponseField name="executionTime" type="integer">
  Time in milliseconds the model took to generate the image.
</ResponseField>

<ResponseField name="output" type="object">
  The generation result containing the image URL and cost.

  <ResponseField name="output.image_url" type="string">
    URL of the generated image. This URL expires after 7 days.
  </ResponseField>

  <ResponseField name="output.cost" type="float">
    Cost of the generation in USD.
  </ResponseField>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
    "status": "COMPLETED",
    "delayTime": 12,
    "executionTime": 1856,
    "output": {
      "image_url": "https://image.runpod.ai/abc123/output.png",
      "cost": 0.005
    }
  }
  ```
</ResponseExample>

<Warning>
  Image URLs expire after 7 days. Download and store generated images immediately if you need to keep them.
</Warning>

## Cost calculation

Z-Image Turbo charges \$0.005 per image generated.
