# Z Image | Turbo | Image to Image | Lora

Creates images from text and reference images with custom LoRA support, powered by Tongyi-MAI’s ultra-fast 6B Z-Image Turbo model for rapid, high-quality generation.

## API Information

- **Model Slug:** z-image-turbo-image-to-image-lora
- **Branded URL:** https://www.eachlabs.ai/zhipu-ai/z-image/z-image-turbo-image-to-image-lora
- **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-lora

## 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. |
| strength | number | No | 0.6 | 0–1 | The strength of the image-to-image conditioning |
| loras | array | No | - | 0–3 | List of LoRA weights to apply |
| 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. |
| 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. |
| 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. |

## 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-lora",
  "input": {
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/z-image-turbo-image-to-image-lora-input.png",
    "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."
  }
}'
```

## 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-lora — Image-to-Image AI Model**

Developed by Zhipu AI as part of the **z-image** family, **z-image-turbo-image-to-image-lora** empowers developers and creators to transform reference images into customized visuals using text prompts and LoRA fine-tuning, all powered by Tongyi-MAI’s ultra-fast 6B Z-Image Turbo architecture for rapid, high-quality **image-to-image AI model** generation.

This **Zhipu AI image-to-image** solution stands out by integrating custom LoRA support directly into the turbocharged diffusion pipeline, enabling personalized style transfers and edits that maintain structural fidelity from input images while adapting to specific artistic or photorealistic directions.

Ideal for **image to image AI model** workflows, it processes inputs like reference photos and descriptive prompts to output refined images in seconds, solving the need for fast, controllable editing without heavy compute demands.

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