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

Интеграция OmniHuman 1.5 API

Используйте OmniHuman 1.5 через Rivya Public API v1: ID модели omnihuman-1-5, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

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

omnihuman-1-5

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

file

Files API

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

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

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

Возможность

Видео

Биллинг

METERED

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

300 символов

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

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

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

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

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
output_resolutionselectНет1080-720, 1080Разрешение результата
pe_fast_modeselectНетfalse-false, trueВыберите запуск с приоритетом качества или более быструю обработку с возможным компромиссом в качестве.
seednumberНет-1--Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1.

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

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

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

Портретное изображение и аудио: Загрузите ровно один портрет JPEG, PNG или WebP размером до 10 MB и один аудиофайл MP3, M4A, WAV, AAC или OGG размером до 10 MB и длительностью менее 60 секунд.

Макс. файлов

2

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

image, audio

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

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

kindМакс. размерMIME-типы
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

Для этой модели не показан запускаемый пример Public API.

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

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      },
      {
        "url": "https://cdn.example.com/reference-audio.wav",
        "kind": "audio",
        "name": "reference-audio.wav",
        "mimeType": "audio/wav",
        "durationSeconds": 12,
        "durationToken": "audio_duration_token_from_files_api"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_omnihuman_1_5_example",
  "status": "queued",
  "model": "omnihuman-1-5",
  "reserved_credits": 27,
  "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.