Image
Kling O1 Image Edit image
Kling O1 Image — high-consistency edit. Edit/Variation only (NOT Create). 1-10 refs, n 1-9.
Category: Edit · kling-o1-image-edit
How to use & limits
- Edit/variation only (does NOT create from scratch): requires source image(s).
- image_urls required: 1 to 10 images.
- resolution: 1K or 2K.
- size: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 or 21:9.
- n: 1 to 9 output images.
- High consistency for character and product; output_format jpeg/png/webp.
Capabilities
What this model supports, straight from the schema — no pricing, no infrastructure detail.
| Capability | Value |
|---|---|
n_max Max variations per job | 9 |
image_edit Image edit | Yes |
image_variation Image variation | Yes |
max_prompt_length Max prompt length | 2000 |
supports_elements Supports elements | Yes |
allowed_resolutions Allowed resolutions | 1K, 2K |
max_reference_images Max reference images | 10 |
Parameters
Fields accepted in params (or first-class, where applicable) for POST /generations.
| Name | Label | Type | Required | Default | Options | Min / Max | Description |
|---|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Required | — | — | — | Editing instruction. Required. |
image_urls | Source image(s) | multi_select | Required | — | — | — | Source image(s): 1 to 10. Required. |
resolution | Resolution | select | Optional | 1K | 1K · 2K | — | Resolution: 1K or 2K. Default 1K. |
size | Size | select | Optional | auto | auto · 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 | — | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 or 21:9. Default auto. |
n | Quantity | number | Optional | 1 | — | 1 – 9 | Number of outputs, integer 1 to 9. Default 1. |
output_format | Output format | select | Optional | png | jpeg · png · webp | — | File format: jpeg, png or webp. Default png. |
Example request
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-o1-image-edit",
"prompt": "Turn the product shot into a premium studio campaign image.",
"params": {
"resolution": "2K",
"size": "16:9",
"n": 2,
"output_format": "png",
"image_urls": [
"https://media.caranguejo.art/inputs/example.png"
]
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "kling-o1-image-edit",
"prompt": "Turn the product shot into a premium studio campaign image.",
"params": {
"resolution": "2K",
"size": "16:9",
"n": 2,
"output_format": "png",
"image_urls": [
"https://media.caranguejo.art/inputs/example.png"
]
}
}),
});
const { data } = await res.json();
Example response
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "kling-o1-image-edit",
"type": "image",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.png",
"type": "image"
}
],
"images": [
{
"url": "https://media.caranguejo.art/outputs/example.png"
}
]
}
}
The job's real cost is returned as credits_charged on the completed response — check GET /balance for the account balance.
Common errors for this job type:
insufficient_credits | Account balance can't cover the job cost. |
content_policy_violation | Prompt or media rejected by content policy. |
generation_timeout | The job exceeded the maximum processing time. |
rate_limited | Too many requests per minute. |
invalid_input | A required parameter is missing or outside the model's schema. |
generation_failed | Generic processing failure. |