ГлавнаяМоделиГенерация изображенийKling Image 3.0

Kling Image 3.0 API

ПровайдерKling

kling-image-3 — генерация изображений-модель от Kling.

high_qualityimage_to_imagetext_to_image

Попробуйте прямо здесь

Kling Image 3.0 Открыть в песочнице

Что умеет Kling Image 3.0

  • Высокое качество
  • Редактирование изображений
  • Изображение по тексту

Стоимость

за изображение
conservative
4.62 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
kling
Modality
image

Kling Image 3.0 API для генерации изображений

Kling Image 3.0 — модель генерации изображений от Kuaishou Technology, китайского провайдера Kling AI, представленная 5 февраля 2026 года. Она выделяется поддержкой нативного вывода в 2K и 4K для профессиональных задач — от визуализации сцен до готовых производственных ассетов. Модель входит в мультимодальную линейку Kling 3.0, объединяющую работу с текстом, изображениями, аудио и видео.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
max: 2500
—
Текстовый промпт описывающий желаемое изображение.
1 пример
Примеры
Девушка в традиционном китайском платье среди цветущей сакуры, рисованный стиль гохуа.
width
integer
—
—
Ширина в px. Парный к height — только валидные комбинации (см. ниже). Несовместимо с resolution.
height
integer
—
—
Высота в px. Парный к width. Список валидных значений — см. combos у width.
resolution
enum
1k, 2k
—
Resolution preset. Несовместимо с width/height. При inputs.referenceImages aspect ratio наследуется из изображения.
seed
integer
—
—
Seed для воспроизводимой генерации. Если не указан — выбирается случайно и возвращается в ответе.
inputs.referenceImages
array of strings
min: 1 · max: 1
—
Reference-изображение (UUID / URL / Data URI / Base64). Только 1 элемент. Используется для image-to-image / edit.
1 пример
Примеры
[
  "https://example.com/ref.jpg"
]
numberResults
integer
min: 1 · max: 20
1
Сколько вариаций сгенерировать. Для image — до 20 за один запрос.
outputType
enum
URL, base64Data, dataURI
URL
Формат доставки: URL — CDN-ссылка (default), base64Data — raw base64, dataURI — data:image/...;base64,...
outputFormat
enum
JPG, PNG, WEBP
JPG
Формат изображения.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии (20–99).
async
boolean
—
false
true → task_id для async-polling. false (default) → sync-ответ сразу.
safety.checkContent
boolean
—
false
Включить проверку контента на NSFW / запрещёнку.
safety.mode
enum
none, fast
none
Режим safety-сканера.
webhookURL
string
—
—
URL для POST-уведомления при готовности async-задачи.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL для автозагрузки готового изображения.
1 пример
Примеры
https://bucket.s3.amazonaws.com/result.png?X-Amz-Signature=...

Поддерживаемые размеры

Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.

1K (1:1)
1024×1024
1K (3:2)
1248×832
1K (2:3)
832×1248
1K (4:3)
1168×880
1K (3:4)
880×1168
1K (9:16)
768×1360
1K (16:9)
1360×768
1K (21:9)
1552×656
2K (1:1)
2048×2048
2K (3:2)
2496×1664
2K (2:3)
1664×2496
2K (4:3)
2336×1760
2K (3:4)
1760×2336
2K (9:16)
1536×2720
2K (16:9)
2720×1536
2K (21:9)
3104×1312

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}.

Sync (HTTP 200)

Sync-ответ (default). HTTP 200 + JSON.

ПолеТипЗначенияОписание
created
integer
—
Unix timestamp когда сгенерировано.
data
array
—
Каждый элемент:
  • url— string · CDN URL картинки (если outputType=URL).
  • b64_json— string · Base64-кодированный PNG/JPG (если outputType=base64Data).
  • taskUUID— string · Идентификатор upstream-задачи (для chain в i2i и т.п.).
  • seed— integer · Использованный seed (если детерминистичная генерация).
provider
string
—
Вендор для отладки.

Async (HTTP 202)

Если в запросе передан async:true → HTTP 202.

ПолеТипЗначенияОписание
id
string
—
task_id для опроса через GET /v1/tasks/{id}.
object
string
image.task
status
enum
queued, processing, completed, failed
model
string
—
Public model id.
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса async-задачи.

ПолеТипЗначенияОписание
id
string
—
object
string
task
status
enum
queued, processing, completed, failed, canceled
modality
string
image
model
string
—
created
integer
—
data
array
—
Каждый элемент:
  • url— string · CDN URL артефакта (если completed).
error
string
—
Сообщение об ошибке (если failed).

Пример кода

kling-image-3_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
    model= "kling-image-3",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    resolution= "1k",
    seed= 1,
    numberResults= 1,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    async= False,
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
    inputs= {
        "referenceImages": []
    },
    safety= {
        "checkContent": False,
        "mode": "none"
    },
)
print(resp)
Полная документация модели

Частые вопросы о Kling Image 3.0

Kling Image 3.0 — модель для создания изображений по текстовым запросам. Через Ranvik API ее удобно подключать к сайтам, сервисам и внутренним продуктам.
Модель помогает быстро получать визуалы для рекламы, концептов, карточек товаров и презентаций. Она поддерживает нативный вывод в разрешении 2K и 4K.
Получить доступ к Kling Image 3.0 можно через Ranvik API. Сервис дает удобный способ интегрировать генерацию изображений в проекты через единый API.
Подключите Kling Image 3.0 через Ranvik API: сервис позволяет работать с API в России без VPN и применять модель в собственных приложениях и автоматизациях.
Да, в Ranvik API доступна оплата в российских рублях. Это упрощает подключение Kling Image 3.0 и помогает контролировать расходы на генерацию изображений.
Kling Image 3.0 выделяется нативной поддержкой 2K и 4K и принадлежностью к мультимодальной линейке Kling 3.0 для работы с разными типами контента.