# Kling | v3 | Image to Image

Kling Image V3 is the latest image generation model from Kling, delivering improved quality, consistency, and visual detail.

## API Information

- **Model Slug:** kling-v3-image-to-image
- **Branded URL:** https://www.eachlabs.ai/kling/kling-v3/kling-v3-image-to-image
- **Provider:** Kling
- **Category:** Image to Image
- **Output Type:** array
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** $0.028 per image (input.num_images, default 1)
- **Estimated Processing Time:** 30 seconds
- **Last Updated:** 2026-07-13
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/kling-v3-image-to-image

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0280
- **Pricing Details:** $0.028 per image (input.num_images, default 1)

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | $0.028 per image (input.num_images, default 1) |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text prompt for image generation. Max 2500 characters. |
| image_url | string | Yes | - | - | Reference image for image-to-image generation. |
| elements | array | No | - | 0–10 | Optional: Elements (characters/objects) to include in the image for face control. |
| resolution | string | No | 1K | 1K,2K | Image generation resolution. 1K: standard, 2K: high-res. |
| aspect_ratio | string | No | 16:9 | 16:9,9:16,1:1,4:3,3:4,3:2,2:3,21:9 | Aspect ratio of generated images. |
| num_images | integer | No | 1 | 1–9 | Number of images to generate (1-9) |
| output_format | string | No | png | jpeg,png,webp | The format of the generated image. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v3-image-to-image",
  "input": {
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/kling-v3-image-to-image-input.png",
    "prompt": "Turn the golden sunset into a dramatic night, starry sky, soft mist, cool blue color grading, strong moon glow, subtle volumetric moon rays, cinematic contrast, realistic night atmosphere."
  }
}'
```

## 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 "X-API-Key: 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 `X-API-Key` |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Kling | v3 | Image to Image** transforms input images into enhanced, high-fidelity outputs using advanced AI from Kuaishou's Kling family. This model excels in generating native 4K images with superior edge clarity, detail, and consistency, solving common issues like upscaling artifacts in traditional image editing workflows. As part of the Kling v3 suite released in early 2026, it builds on the family's multimodal foundation, offering creators print-ready visuals directly from reference images and text prompts.

Developed by Kuaishou, Kling | v3 | Image to Image stands out for its **native 4K output without upsampling**, delivering crisp results ideal for professional design and cinematic stills. Whether refining concepts or creating series, it provides seamless image-to-image generation on each::labs, empowering users with Kling | v3 | Image to Image API access for integrated workflows.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `X-API-Key: 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.