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

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

ID моделі API

omnihuman-1-5

Входи

file

Files API

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

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

per_input_second · default=27 · ⌈total⌉

Можливість

Відео

Білінг

METERED

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

300 символів

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

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

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

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

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
output_resolution	select	Ні	1080	-	720, 1080	Роздільна здатність виходу
pe_fast_mode	select	Ні	false	-	false, true	Виберіть запуск із пріоритетом якості або швидшу обробку з можливим компромісом у якості.
seed	number	Ні	-1	-	-	Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.

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

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

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

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

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

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

image, audio

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

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

kind	Максимальний розмір	MIME-типи
image	10 MB	image/jpeg, image/png, image/webp
audio	10 MB	audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg

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

{
  "model": "omnihuman-1-5",
  "params": {
    "output_resolution": "1080",
    "pe_fast_mode": "false",
    "seed": -1
  }
}

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

{
  "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.

API-інтеграція для OmniHuman 1.5