# Kling O1 Image

> Kuaishou's Kling O1 image editing model with strong multi-reference control. Compose up to 10 reference images and character elements in a single prompt using @Image1 / @Element1 placeholders, transforming subjects, styles, and local details while preserving visual consistency.

- **Provider**: fal
- **Model ID**: fal-ai/kling-image/o1
- **Category**: image_generation
- **Credits**: 66 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `aspect_ratio` (string, optional): Aspect ratio of the generated images. 'auto' picks one based on the input content. (Default: `auto`; Options: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`)
- `output_format` (string, optional): The format of the generated image. (Default: `png`; Options: `jpeg`, `png`, `webp`)
- `elements` (array, optional): Characters or objects to include, referenced in the prompt as @Element1, @Element2, ... Maximum 10 total (elements + reference images combined).
- `image_urls` (array, **required**): Reference images, 1-indexed in the prompt as @Image1, @Image2, ... Maximum 10 (elements + reference images combined).
- `prompt` (string, **required**): Text prompt for image generation. Reference the supplied images as @Image1, @Image2, ... (1-indexed; use @Image when there is only one) and character elements as @Element1, @Element2, ...
- `resolution` (string, optional): Output resolution. 1K is standard, 2K is high-res. Both cost the same. (Default: `1K`; Options: `1K`, `2K`)
- `num_images` (integer, optional): Number of images to generate. Charged per image. (Default: `1`; Range: min: 1, max: 9)

## Example Request

```json
{
  "model": "fal-ai/kling-image/o1",
  "input": {
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_inputs/kling-image-o1/input.png",
      "https://storage.googleapis.com/falserverless/example_inputs/kling-image-o1/input-2.png"
    ],
    "aspect_ratio": "auto",
    "output_format": "png",
    "prompt": "Place @Image1 on the marble counter in @Image2, matching the warm window light and keeping the product label fully legible",
    "resolution": "1K",
    "num_images": 1
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

image-editing, image-to-image, kling, reference-control, character-consistency, typography

## Documentation

https://fal.ai/models/fal-ai/kling-image/o1