# Z Image | Turbo | Image to Image

Generates images from text and reference images using Tongyi-MAI’s ultra-fast 6B Z-Image Turbo model for fast, high-quality visual results.

## API Information

- **Model Slug:** z-image-turbo-image-to-image
- **Branded URL:** https://www.eachlabs.ai/zhipu-ai/z-image/z-image-turbo-image-to-image
- **Provider:** Zhipu AI
- **Category:** Image to Image
- **Output Type:** array
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Per-megapixel pricing (round rounding)
- **Estimated Processing Time:** 10 seconds
- **Last Updated:** 2026-04-29
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/z-image-turbo-image-to-image

## Pricing

- **Charge Type:** dynamic
- **Pricing Details:** Per-megapixel pricing (round rounding)

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| output.width < "708" AND output.height < "708" | Minimum 1 MP for small images (< 708x708, round rounding) |
| Rule 2 | Per-megapixel pricing (round rounding) |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | The prompt to generate an image from. |
| image_url | string | Yes | - | - | URL of Image for Image-to-Image generation. |
| image_size | string | No | auto | square_hd,square,portrait_4_3,portrait_16_9,landscape_4_3,landscape_16_9,auto | The size of the generated image. |
| num_inference_steps | integer | No | 8 | 1–8 | The number of inference steps to perform. |
| strength | number | No | 0.6 | 0–1 | The strength of the image-to-image conditioning. |
| num_images | integer | No | 1 | 1–4 | The number of images to generate. |
| enable_safety_checker | boolean | No | true | - | If set to true, the safety checker will be enabled. |
| enable_prompt_expansion | boolean | No | false | - | Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request. |
| output_format | string | No | png | jpeg,png,webp | The format of the generated image. |
| acceleration | string | No | none | none,regular,high | The acceleration level to use. |
| seed | integer | No | - | - | The same seed and the same prompt given to the same version of the model will output the same image every time. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image-turbo-image-to-image",
  "input": {
    "prompt": "Woman standing in front of the Eiffel Tower at sunset, warm golden sunlight, soft breeze moving her hair, wearing a dress, Paris atmosphere, cozy and elegant mood.",
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/z-image-turbo-image-to-image-input.png"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "array",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**z-image-turbo-image-to-image — Image-to-Image AI Model**

z-image-turbo-image-to-image, developed by Zhipu AI as part of the z-image family and powered by Alibaba’s Tongyi Lab, delivers ultra-fast image transformations using its 6 billion parameter Z-Image Turbo model. This **image-to-image AI model** excels in sub-second inference on enterprise hardware, enabling seamless enhancements from subtle upscaling to dramatic artistic reimaginings controlled by a single strength parameter. Developers and creators seeking a **Zhipu AI image-to-image** solution appreciate its bilingual text rendering and precise control, generating high-quality visuals at resolutions up to 2048x2048 pixels without switching tools.

Unlike traditional editors, z-image-turbo-image-to-image operates on a flexible spectrum: low strength values sharpen and detail reference images like advanced upscaling, while high values use the input as loose inspiration for new compositions. Integrated prompt enhancement ensures optimal results from simple inputs, making it ideal for **AI image editor API** integrations in workflows demanding speed and quality.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.