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

Kling Image O3

ПровайдерKling

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

high_qualityimage_to_imagetext_to_image

Что умеет Kling Image O3

  • Высокое качество
  • Image-to-Image
  • Text-to-image

Стоимость

за изображение
1K / 2K
7.84 ₽
4K
15.68 ₽

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

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

Vendor
kling
Modality
image

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
min: 1 · max: 2500
—
Текстовый промпт описывающий желаемое изображение.
1 пример
Примеры
Кибернетический волк бежит по неоновому городу, ультрадетализированная иллюстрация.
widthreq
integer
—
—
Ширина в px. Парный к height (REQUIRED) — только валидные комбинации (см. ниже).
heightreq
integer
—
—
Высота в px. Парный к width (REQUIRED). Список валидных значений — см. combos у width.
inputs.referenceImages
array of strings
min: 1 · max: 10
—
Reference-изображения (UUID / URL / Data URI / Base64). До 10 шт — для image-to-image / edit / multi-reference.
1 пример
Примеры
[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.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
4K (1:1)
4096×4096
4K (3:2)
4992×3328
4K (2:3)
3328×4992
4K (4:3)
4736×3520
4K (3:4)
3520×4736
4K (9:16)
3072×5440
4K (16:9)
5440×3072
4K (21:9)
6272×2688

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

Что возвращает 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-o3_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-o3",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    "inputs.referenceImages": [],
    numberResults= 1,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    async= False,
    "safety.checkContent": False,
    "safety.mode": "none",
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
)
print(resp)
Полная документация модели