Создаёт и редактирует изображения до 8K и делает серии до 10 картинок в одном стиле. Цена: 2K — 9 ₽, 4K — 14 ₽, 8K — 22 ₽ за изображение, каждое загруженное изображение — плюс 0,5 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Kling Image 4.0 рисует картинки по текстовому заданию и по вашим образцам в 2K, 4K и 8K. Хорошо держит фотореализм и умеет писать на изображении точный текст, в том числе по-русски. Через API доступны два сценария:
Каждый вызов создаёт асинхронную операцию: сначала вы получаете её id, потом забираете результат по этому id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус queued. Генерация идёт в фоне.Сценарий выбирается полем generation_type:
generation_type | Что получится | Нужные поля |
|---|---|---|
image | 1-9 изображений | prompt, по желанию image_urls, aspect_ratio, resolution, count |
series | 2-10 изображений в одном стиле | prompt, по желанию image_urls, aspect_ratio, resolution, series_count |
{
"tool": "kling-image-4-0",
"input": {
"generation_type": "image",
"prompt": "Чашка капучино на деревянном столе у окна, утренний свет, фотореализм",
"aspect_ratio": "4:3",
"resolution": "2k",
"count": 1
}
}
tool - slug нейросети, input - параметры генерации. Поля передаются прямо внутри input, дополнительный вложенный объект не нужен. Поля другого сценария можно не передавать: они не используются.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generation_type | enum | Нет | Сценарий: image (изображение) или series (серия). Если не передать, будет image. |
prompt | string | Да | Что должно получиться, от 3 до 19 000 символов. Текст, который нужно написать на картинке, возьмите в кавычки. На загруженные изображения можно ссылаться как @image1, @image2 - по порядку в image_urls. |
image_urls | string[] (url) | Нет | Образцы: люди, предметы, стиль, фон. До 10 ссылок, форматы .jpg, .jpeg, .png. Без ссылок картинка создаётся только по заданию. |
aspect_ratio | enum | Нет | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9. При auto нейросеть подбирает пропорции по заданию и образцам. По умолчанию auto. |
resolution | enum | Нет | 2k, 4k или 8k. По умолчанию 2k. |
count | number | Нет | Только для image. Сколько изображений сделать, от 1 до 9. По умолчанию 1. |
series_count | number | Нет | Только для series. Сколько изображений в серии, от 2 до 10. По умолчанию 4. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0f6b1c1e-6a1d-4f3f-9c55-2d8a7f1b9e01" \
-d '{
"tool": "kling-image-4-0",
"input": {
"generation_type": "image",
"prompt": "Постер кофейни в стиле ретро, крупная надпись \"Утро начинается здесь\", тёплые цвета",
"aspect_ratio": "3:4",
"resolution": "4k",
"count": 2
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
tool: 'kling-image-4-0',
input: {
generation_type: 'image',
prompt:
'Постер кофейни в стиле ретро, крупная надпись "Утро начинается здесь", тёплые цвета',
aspect_ratio: '3:4',
resolution: '4k',
count: 2,
},
}),
})
const operation = await response.json()
console.log(operation.id, operation.status)
import uuid
import requests
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={
"Authorization": "Bearer brth_ваш_ключ",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"tool": "kling-image-4-0",
"input": {
"generation_type": "image",
"prompt": "Постер кофейни в стиле ретро, крупная надпись \"Утро начинается здесь\", тёплые цвета",
"aspect_ratio": "3:4",
"resolution": "4k",
"count": 2,
},
},
)
operation = response.json()
print(operation["id"], operation["status"])
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "kling-image-4-0",
"input": {
"generation_type": "image",
"prompt": "Девушка с @image1 сидит в кресле с @image2 в светлой гостиной, мягкий дневной свет",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.png"
],
"aspect_ratio": "auto",
"resolution": "2k"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'kling-image-4-0',
input: {
generation_type: 'image',
prompt:
'Девушка с @image1 сидит в кресле с @image2 в светлой гостиной, мягкий дневной свет',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/source-image-2.png',
],
aspect_ratio: 'auto',
resolution: '2k',
},
}),
})
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={"Authorization": "Bearer brth_ваш_ключ"},
json={
"tool": "kling-image-4-0",
"input": {
"generation_type": "image",
"prompt": "Девушка с @image1 сидит в кресле с @image2 в светлой гостиной, мягкий дневной свет",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.png",
],
"aspect_ratio": "auto",
"resolution": "2k",
},
},
)
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "kling-image-4-0",
"input": {
"generation_type": "series",
"prompt": "Раскадровка короткой истории: лиса находит в лесу старый фонарь и идёт за его светом. Акварель",
"aspect_ratio": "16:9",
"resolution": "2k",
"series_count": 6
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'kling-image-4-0',
input: {
generation_type: 'series',
prompt:
'Раскадровка короткой истории: лиса находит в лесу старый фонарь и идёт за его светом. Акварель',
aspect_ratio: '16:9',
resolution: '2k',
series_count: 6,
},
}),
})
response = requests.post(
"https://bratuha.ru/api/v1/operations",
headers={"Authorization": "Bearer brth_ваш_ключ"},
json={
"tool": "kling-image-4-0",
"input": {
"generation_type": "series",
"prompt": "Раскадровка короткой истории: лиса находит в лесу старый фонарь и идёт за его светом. Акварель",
"aspect_ratio": "16:9",
"resolution": "2k",
"series_count": 6,
},
},
)
{
"id": "op_uuid-123",
"status": "queued",
"tool": "kling-image-4-0",
"cost": 28,
"balance_after": 472,
"created_at": "2026-11-19T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "kling-image-4-0",
"cost": 28,
"created_at": "2026-11-19T12:00:00Z",
"completed_at": "2026-11-19T12:00:48Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/kling-image-4-0/image-1.png",
"https://storage.bratuha.ru/results/kling-image-4-0/image-2.png"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "kling-image-4-0",
"cost": 28,
"created_at": "2026-11-19T12:00:00Z",
"completed_at": "2026-11-19T12:00:15Z",
"result": null,
"error_message": "Не удалось сгенерировать изображение по этому запросу"
}
Сохраните id из ответа на создание и проверяйте статус операции по нему:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
const status = await fetch(
'https://bratuha.ru/api/v1/operations/op_uuid-123',
{
headers: { Authorization: 'Bearer brth_ваш_ключ' },
},
)
const result = await status.json()
Опрашивайте раз в 5-10 секунд, пока статус не станет completed или failed. Одна картинка обычно готова за одну-три минуты, серия из нескольких кадров - за три-пять минут.
В result приходит type: "image" и массив urls:
image - столько ссылок, сколько указано в count;series - столько ссылок, сколько указано в series_count, по порядку серии.В 2K и 4K изображения обычно приходят в PNG, в 8K - в JPEG. Не завязывайтесь на расширение файла в ссылке.
Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.
Цена считается за каждое изображение по resolution и умножается на count или series_count:
resolution | За изображение |
|---|---|
2k | 9 ₽ |
4k | 14 ₽ |
8k | 22 ₽ |
Загруженные изображения - к любой цене прибавляется 0,5 ₽ за каждую ссылку в image_urls. Доплата берётся один раз за операцию, а не за каждую картинку результата.
Примеры:
2k без образцов - 9 ₽;8k по двум образцам - 22 × 3 + 2 × 0,5 = 67 ₽;4k - 14 × 6 = 84 ₽;2k по одному образцу - 9 × 4 + 0,5 = 36,5 ₽.Пропорции на цену не влияют. Итоговую сумму сервер возвращает в поле cost сразу при создании операции.
Idempotency-Key: повтор того же запроса в течение 24 часов вернёт исходную операцию без повторного списания. Без заголовка повтор создаёт новую операцию и списывает деньги ещё раз.max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.queued, затем проверяйте статус по id.http/https ссылки без localhost, loopback и private IP. Форматы - только .jpg, .jpeg и .png.@ для почты и ников: он зарезервирован для ссылок на образцы (@image1, @image2).