Документація Rivya AI
Сторінки API моделей

API-інтеграція для Kling V2.1 Standard

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

Доступно через APIГотовністьВідео
ID моделі API

kling-v2-1-standard

Входи

file

Files API

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

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

per_video · 5s=25 · 10s=50 · ⌈total⌉

Можливість

Відео

Білінг

FIXED

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

5000 символів

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

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

КлючТипОбов'язковоЗа замовчуваннямОпис
modelstringТакkling-v2-1-standardВикористовуйте kling-v2-1-standard як ID моделі API.
promptstringТак-Максимум 5000 символів для цієї моделі.
paramsobjectНі-Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_idstringНі-Необов'язковий клієнтський ID для трасування запитів у вашій системі.

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

КлючТипОбов'язковоЗа замовчуваннямДіапазонОпціїОпис
durationselectНі5-5, 10Тривалість
negative_prompttextНі---Негативний промпт
cfg_scalenumberНі0.5min 0 / max 1 / step 0.1-Керує тим, наскільки щільно результат слідує вашому промпту. Вищі значення зазвичай тримаються ближче до промпту, але також можуть зробити рух або композицію жорсткішими.

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

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

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

Референсне зображення: Режим приймає 1 файл зображення як початковий кадр. JPEG/PNG ≤ 10 MB.

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

1

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

image

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

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

kindМаксимальний розмірMIME-типи
image10 MBimage/jpeg, image/png

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

{
  "model": "kling-v2-1-standard",
  "params": {
    "duration": "5",
    "negative_prompt": "Опишіть, чого відео має уникати",
    "cfg_scale": 0.5
  }
}

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

{
  "model": "kling-v2-1-standard",
  "params": {
    "duration": "5",
    "negative_prompt": "Опишіть, чого відео має уникати",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_kling_v2_1_standard_example",
  "status": "queued",
  "model": "kling-v2-1-standard",
  "reserved_credits": 25,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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.