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

Интеграция Kling O3 API

Используйте Kling O3 через Rivya Public API v1: ID модели kling-o3, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

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

kling-o3

Входные данные

text, file

Files API

Требуется для референсных режимов

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

Ставка в кредитах: 14–67 / секунду результата Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Видео

Биллинг

METERED

Лимит промпта

3072 символов

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

КлючТипОбязательноПо умолчаниюОписание
modelstringДаkling-o3Используйте kling-o3 как ID модели API.
promptstringДа-Максимум 3072 символов для этой модели.
paramsobjectНет-Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_idstringНет-Необязательный клиентский id для трассировки запросов в вашей системе.

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

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
resolutionselectНет720p-720p, 1080p, 4kРежим генерации
durationselectНет5-3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Длительность
audioselectНетfalse-false, trueГенерировать аудио
aspect_ratioselectНет16:9-16:9, 9:16, 1:1Соотношение сторон

Политика загрузки

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

Правило референсных материалов

Референсные медиа: Загрузите в сумме до 2 файлов изображений для проектов image-to-video.

Макс. файлов

2

Принимаемые типы файлов

image

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kindМакс. размерMIME-типы
image10 MBimage/jpeg, image/png

Минимальный запрос

{
  "model": "kling-o3",
  "prompt": "Камера медленно обходит флакон продукта на столе в студии.",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "false",
    "aspect_ratio": "16:9"
  }
}

Запрос с референсным файлом

{
  "model": "kling-o3",
  "prompt": "Камера медленно обходит флакон продукта на столе в студии.",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "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_o3_example",
  "status": "queued",
  "model": "kling-o3",
  "reserved_credits": 70,
  "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.