# Kling O1

Performs precise image edits with strong reference control, transforming subjects, styles, and local details while preserving overall visual consistency.

## API Information

- **Model Slug:** kling-o1
- **Branded URL:** https://www.eachlabs.ai/kling/kling-o1/kling-o1
- **Provider:** Kling
- **Category:** Image to Image
- **Output Type:** array
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Charge $0.028 per image generation
- **Estimated Processing Time:** 0 seconds
- **Last Updated:** 2026-04-06
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/kling-o1

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0280
- **Pricing Details:** Charge $0.028 per image generation

### Pricing Rules

| Rule | Condition | Price |
| --- | --- | --- |
| multiply_numeric | num_images (per unit) | $0.0280 |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text prompt for image generation. Reference images using @Image1, @Image2, etc. (or @Image if only one image). Max 2500 characters. |
| image_urls | array | Yes | - | 1–10 | List of reference images. Reference images in prompt using @Image1, @Image2, etc. (1-indexed). Max 10 images. |
| resolution | string | No | 1K | 1K,2K | Image generation resolution. 1K: standard, 2K: high-res. |
| num_images | integer | No | 1 | 1–9 | Number of images to generate (1-9). |
| aspect_ratio | string | No | auto | auto,16:9,9:16,1:1,4:3,3:4,3:2,2:3,21:9 | Aspect ratio of generated images. 'auto' intelligently determines based on input content. |
| 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-o1",
  "input": {
    "prompt": "Put @Image1 on the horse in @Image2",
    "image_urls": [
      "https://storage.googleapis.com/magicpoint/inputs/kling-o1-input-1.png",
      "https://storage.googleapis.com/magicpoint/inputs/kling-o1-input-2.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 "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-o1 — Image Editing AI Model**

kling-o1 is Kling's unified multimodal AI model designed for precise image editing and transformation. Unlike traditional image-to-image tools that apply broad stylistic changes, kling-o1 excels at controlled, reference-based edits where you maintain exact control over what changes and what stays consistent. Whether you're refining character designs, adapting product imagery across contexts, or maintaining brand consistency across visual assets, kling-o1 delivers professional-grade results without manual cleanup.

The model's core strength lies in its ability to accept multiple input types—text prompts combined with reference images—and apply transformations while preserving structural integrity and visual coherence. This makes it particularly valuable for workflows requiring both creative flexibility and strict consistency, such as e-commerce product editing, character animation preparation, and branded content creation.

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