Використовуйте Kling 3.0 через Rivya Public API v1 з ID моделі kling-3-0, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

Доступно через APIТекст або URL готові; референсні режими використовують Files APIВідео

ID моделі API

kling-3-0

Входи

text, file

Files API

Потрібно для референсних режимів

Базові кредити

Можливість

Відео

Білінг

FIXED

Ліміт промпта

2000 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

Ключ	Тип	Обов'язково	За замовчуванням	Опис
model	string	Так	kling-3-0	Використовуйте kling-3-0 як ID моделі API.
prompt	string	Так	-	Максимум 2000 символів для цієї моделі.
params	object	Ні	-	Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_id	string	Ні	-	Необов'язковий клієнтський ID для трасування запитів у вашій системі.

Параметри моделі

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
mode	select	Ні	pro	-	std, pro	Режим генерації
multi_shots	select	Ні	false	-	false, true	Режим кадрів
duration	select	Ні	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15	Тривалість
sound	select	Ні	false	-	false, true	Генерувати аудіо
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1	Співвідношення сторін

Політика завантаження

Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.

Правило референсів

Референсні матеріали: Завантажте загалом до 2 файлів зображень для проєктів із зображення у відео.

Максимум файлів

Прийняті типи файлів

image

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kind	Максимальний розмір	MIME types
image	10 MB	image/jpeg, image/png, image/webp

Мінімальний запит

{
  "model": "kling-3-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

Запит із референсним файлом

{
  "model": "kling-3-0",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Відповідь створення

Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.

{
  "id": "task_kling_3_0_example",
  "status": "queued",
  "model": "kling-3-0",
  "reserved_credits": 90,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Поширені помилки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Деякі режими потребують завантаження референсів через Files API.

API-інтеграція для Kling 3.0