Переглядайте ID моделей Rivya API, доступність, підтримувані режими, таблиці параметрів, ліміти prompt, правила референс-медіа та посилання на сторінки моделей.

Ця сторінка є довідником API на рівні моделей для Rivya API v1.

Таблиця нижче генерується з того самого каталогу моделей і публічного серіалізатора, які використовує /api/v1/models. Це не вручну зафіксована кількість моделей.

Як читати цей довідник

Використовуйте id моделі як model у POST /api/v1/generations для асинхронних моделей зображень, відео й аудіо.
Використовуйте ID chat-моделей у POST /api/v1/chat/completions.
Використовуйте верхньорівневий prompt для тексту prompt генерації.
Використовуйте верхньорівневий message для ходів Chat API.
Поля, специфічні для асинхронної моделі, розміщуйте всередині params.
Перед побудовою інтеграції читайте api_input_status. available_text і available_url_input можна тестувати без завантаження файлів; partial_requires_files означає, що лише деякі режими потребують Files API; requires_files_api означає, що перед викликом моделі треба завантажити референс-медіа через Files API.
Для chat-моделей читайте chat_capabilities: підтримка відповідей без потокового передавання, потокового передавання SSE, вкладень зображень через file_id, веб-пошуку, режиму думок і керування зусиллям міркування.
Сторінки деталей моделей дають продуктові рекомендації та приклади.

Використовуйте цей довідник із налагоджувачем

Почніть зі швидкого старту, підтвердьте тут поля моделі, а потім запустіть mock або авторизований live-запит у налагоджувачі Developers.

API Quickstart Онлайн-налагоджувач

Z-Image

z-imageДоступно через APIТекстовий ввід готовий

Зображення · Легка модель Alibaba для створення зображень із тексту. Швидка генерація одного зображення з 5 співвідношеннями сторін, ідеальна для швидких концепт-чернеток і візуалів для соцмереж лише за 1 кредит.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

1000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Доступно через APIЧастково: потрібен Files API

Зображення · Нова генерація моделі зображень Google з роздільною здатністю 4K, 15 співвідношеннями сторін (включно з екстремальним 8:1), прив'язкою до Google Search і підтримкою до 14 референсних зображень - найгнучкіший генератор зображень у Rivya.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

20000 символів

Референсні медіа

image · 14 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	Ні	1K	-	1K, 2K, 4K
output_format	select	Ні	jpg	-	jpg, png
google_search	select	Ні	false	-	false, true

Nano Banana Pro

nano-banana-proДоступно через APIЧастково: потрібен Files API

Зображення · Преміальна модель зображень Google з 4K-виводом, 11 співвідношеннями сторін і підтримкою до 8 референсних зображень. Оптимізована для високоточних бренд- і кампанійних візуалів із кращою деталізацією та точністю кольору.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

10000 символів

Референсні медіа

image · 8 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	Ні	1K	-	1K, 2K, 4K
output_format	select	Ні	png	-	png, jpg

Nano Banana

nano-bananaДоступно через APIЧастково: потрібен Files API

Зображення · Гнучка модель зображень Google для генерації з тексту в зображення та зображення в зображення з 11 співвідношеннями сторін, підтримкою до 10 референсних зображень і виводом PNG/JPEG. Добре підходить для портретів, продуктових композицій і ширших візуалів для лендингів.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 10 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
imageSize	select	Ні	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	Ні	png	-	png, jpeg

GPT Image 2

gpt-image-2Доступно через APIЧастково: потрібен Files API

Зображення · Новіша модель GPT Image від OpenAI у Rivya: підтримує генерацію з тексту, редагування зображень за зображенням, до 16 референсних зображень і зрозумілі кредитні рівні 1K / 2K / 4K.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

20000 символів

Референсні медіа

image · 16 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

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

Референсні зображення: Завантажте до 16 референсних зображень для image-to-image задач GPT Image 2.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	Ні	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Доступно через APIЧастково: потрібен Files API

Зображення · Модель зображень OpenAI із середнім/високим рівнями якості та підтримкою до 16 референсних зображень. Вона добре виконує складні інструкції й рендерить цілісні сцени з точними просторовими зв'язками.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

Референсні медіа

image · 16 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
quality	select	Ні	medium	-	medium, high
aspect_ratio	select	Ні	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageДоступно через APIТекстовий ввід готовий

Зображення · Модель OpenAI 4o Image тепер доступна в Rivya як окремий шлях перетворення тексту на зображення. Налаштування сторінки поки свідомо вузьке: промпт і 3 підтримувані співвідношення сторін за фіксовані 3 кредити за зображення.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
size	select	Ні	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteДоступно через APIЧастково: потрібен Files API

Зображення · Легша модель зображень Seedream від ByteDance зі спільною ціною для text-to-image і редагування зображень. Вона підтримує 8 співвідношень сторін, до 14 референсних зображень і зараз коштує 6 кредитів за запуск.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

3000 символів

Референсні медіа

image · 14 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Ні	basic	-	basic, high

Seedream 4.5

seedream-4-5Доступно через APIЧастково: потрібен Files API

Зображення · Висококласна модель зображень ByteDance з рівнями якості 2K/4K, 8 співвідношеннями сторін і підтримкою до 14 референсних зображень. Відома кінематографічним color grading і багатою деталізацією текстур у fashion та lifestyle-візуалах.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

3000 символів

Референсні медіа

image · 14 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Ні	basic	-	basic, high

Seedream 4.0

seedream-4-0Доступно через APIЧастково: потрібен Files API

Зображення · Seedream 4.0 - збалансована модель зображень ByteDance у Rivya для генерації text-to-image, редагування за референсним зображенням і явних елементів керування виводом.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 10 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

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

Референсні зображення: Завантажте до 10 зображень для шляху редагування Seedream 4.0.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	Ні	1K	-	1K, 2K, 4K
max_images	number	Ні	1	min 1 / max 6 / step 1	-
seed	number	Ні	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	Ні	false	-	false, true

Seedream 3.0

seedream-3-0Доступно через APIТекстовий ввід готовий

Зображення · Seedream 3.0 тепер повертається у Rivya як окрема legacy-модель для зображень. Зараз вона зберігає лише публічний шлях text-to-image і коштує 5 кредитів за запуск.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	Ні	2.5	min 1 / max 10 / step 0.1	-
seed	number	Ні	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineДоступно через APIЧастково: потрібен Files API

Зображення · Модель зображень xAI із сильною творчою інтерпретацією та 5 співвідношеннями сторін. Генерація одного зображення з фокусом на художній виразності й нестандартних візуальних стилях.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

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

Референсне зображення: Завантажте до 1 файлу зображення для відповідних генераційних задач.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	Ні	false	-	false, true

Flux 2 Pro

flux-2-proДоступно через APIЧастково: потрібен Files API

Зображення · Флагман Black Forest Labs із 32B параметрами. Підтримує текст у зображення та зображення в зображення з до 8 референсними зображеннями, роздільністю 2K і точним рендерингом тексту — створений для продуктових знімків і бренд-візуалів.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 8 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Ні	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexДоступно через APIЧастково: потрібен Files API

Зображення · Варіант сімейства Flux 2, сфокусований на редагуванні. Спеціалізується на структурних корекціях і перенесенні стилю з підтримкою до 8 референсних зображень і роздільності 2K — ідеально для ітерацій над наявними візуалами.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 8 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Ні	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxДоступно через APIЧастково: потрібен Files API

Зображення · Покращена модель Flux Kontext від Black Forest Labs для вимогливіших задач генерації та редагування зображень за промптом. Rivya зараз тримає текст у зображення й зображення в зображення в одному асинхронному проєкті та оцінює їх фіксовано у 8 кредитів за запуск згідно з поточною політикою платформи.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Опційний текст водяного знака"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Ні	jpeg	-	jpeg, png
enableTranslation	select	Ні	true	-	true, false
promptUpsampling	select	Ні	false	-	false, true
safetyTolerance	number	Ні	2	min 0 / max 6	-
watermark	text	Ні	-	-	-

Flux Kontext Pro

flux-kontext-proДоступно через APIЧастково: потрібен Files API

Зображення · Доступніший проєкт Flux Kontext від Black Forest Labs для тексту в зображення та редагування одного зображення. Rivya зараз відкриває і текст у зображення, і зображення в зображення в одному асинхронному проєкті зображень, із фіксованою ціною 4 кредити для обох режимів за поточною політикою платформи.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Опційний текст водяного знака"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Ні	jpeg	-	jpeg, png
enableTranslation	select	Ні	true	-	true, false
promptUpsampling	select	Ні	false	-	false, true
safetyTolerance	number	Ні	2	min 0 / max 6	-
watermark	text	Ні	-	-	-

Qwen2 Image

qwen2-imageДоступно через APIЧастково: потрібен Files API

Зображення · Модель зображень Alibaba Qwen2 зараз інтегрована в Rivya як один проєкт зображень із фіксованою ціною. Вона безпечно покриває генерацію з тексту в зображення та зображення в зображення зі спільним набором співвідношень сторін, який відкритий в обох публічних документаціях, а також вивід PNG/JPEG, повторне використання seed і простий NSFW-перемикач.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

800 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
image_size	select	Ні	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	Ні	png	-	png, jpeg
seed	number	Ні	-	min 0	-
nsfw_checker	select	Ні	false	-	false, true

Qwen Image

qwen-imageДоступно через APIЧастково: потрібен Files API

Зображення · Модель зображень родини Alibaba Qwen з HD-пресетами (квадрат, портрет, ландшафт) і виводом PNG/JPEG. Сильна в китайськомовних промптах і культурно нюансованій візуальній генерації.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	Ні	png	-	png, jpeg

Midjourney

midjourneyДоступно через APIЧастково: потрібен Files API

Зображення · Модель зображень Midjourney V7 для генерації з тексту в зображення та зображення в зображення з anime-режимами Niji, 3 рівнями швидкості (Relaxed/Fast/Turbo), стильовими референсами й узгодженістю через Omni Reference. Вона досі є еталоном для кінематографічного арту, ілюстрацій і мудбордів.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

2000 символів

Референсні медіа

image · 4 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

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

Референсне зображення: Завантажте до 4 файлів зображень для image-проєктів.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
speed	select	Ні	relaxed	-	relaxed, fast, turbo
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	Ні	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundДоступно через APIПотрібен Files API

Зображення · Модель Recraft для видалення фону в Rivya, створена для ізоляції об'єкта з одного наявного зображення. Використовуйте її, коли наступному кроку потрібен прозорий матеріал, чистий виріз або вихідне зображення без оригінального фону.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вихідне зображення: Завантажте рівно 1 зображення. Чіткіші краї об'єкта зазвичай дають чистіший виріз.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

Додатковий параметр моделі не потрібен.

Recraft Crisp Upscale

recraft-crisp-upscaleДоступно через APIПотрібен Files API

Зображення · Легка модель Recraft для збільшення зображень у Rivya, створена для недорогого підсилення різкості й чіткості на одному затвердженому кадрі. Використовуйте її, коли вибраному зображенню потрібен лише дешевий фінальний полірувальний прохід перед експортом, а не важче збільшення рівня доставки.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вихідне зображення: Завантажте рівно 1 зображення. Ця опція призначена для швидкого низьковартісного полірувального проходу.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

Додатковий параметр моделі не потрібен.

Wan 2.7 Image Pro

wan-2-7-image-proДоступно через APIЧастково: потрібен Files API

Зображення · Вищий image-модельний рівень Wan 2.7 від Alibaba, зараз відкритий у Rivya як окремий image-слот для text-to-image та редагування зображень. Ціна лишається фіксованою на рівні 12 кредитів за запуск завдяки явному обмеженню генерації одним вихідним зображенням.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 9 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Ні	2K	-	1K, 2K
watermark	select	Ні	false	-	false, true
seed	number	Ні	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageДоступно через APIЧастково: потрібен Files API

Зображення · Стандартна модель зображень Wan 2.7 від Alibaba доступна в Rivya як окремий слот для створення зображень із тексту та редагування зображень і зараз коштує 5 кредитів за запуск.

API-гайд Сторінка моделі

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

Режими

text-to-image, image-to-image

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 9 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Ні	2K	-	1K, 2K
watermark	select	Ні	false	-	false, true
seed	number	Ні	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraДоступно через APIТекстовий ввід готовий

Зображення · Google Imagen4 Ultra — преміальний рівень Imagen для тексту в зображення у Rivya. Зараз він інтегрований як проєкт з одним зображенням, фіксованою ціною 12 кредитів і публічними контролями промпту, негативного промпту, співвідношення сторін і сіду.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Необов'язкові речі, яких слід уникати",
    "seed": "Необов'язкове значення сіду"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Ні	-	-	-
seed	text	Ні	-	-	-

Google Imagen4

google-imagen4Доступно через APIТекстовий ввід готовий

Зображення · Google Imagen4 — стандартний рівень Imagen для тексту в зображення у Rivya. Зараз він інтегрований як проєкт з одним зображенням, фіксованою ціною 8 кредитів і публічними контролями промпту, негативного промпту, співвідношення сторін і сіду.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Необов'язкові речі, яких слід уникати",
    "seed": "Необов'язкове значення сіду"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Ні	-	-	-
seed	text	Ні	-	-	-

Google Imagen4 Fast

google-imagen4-fastДоступно через APIТекстовий ввід готовий

Зображення · Google Imagen4 Fast — легкий рівень Imagen для тексту в зображення у Rivya. Зараз він зберігає проєкт з одним зображенням, використовує фіксовану ціну 4 кредити й відкриває публічні контролі промпту, негативного промпту, співвідношення сторін і сіду без багатозображеневого виводу.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "Необов'язкові речі, яких слід уникати",
    "seed": 0
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspect_ratio	select	Ні	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Ні	-	-	-
seed	number	Ні	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleДоступно через APIПотрібен Files API

Зображення · Збільшувач зображень Topaz у Rivya для фінальної передачі затверджених статичних кадрів, яким потрібен справжній стрибок розміру. Використовуйте його, коли композиція вже фінальна, а залишилися тільки роздільна здатність експорту, розмір для перегляду або готовність до друку.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вихідне зображення: Завантажте 1 затверджене зображення, яке хочете зберегти. Цей варіант призначений для збільшення, а не для творчого повторного редагування.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
upscale_factor	select	Ні	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3Доступно через APIТекстовий ввід готовий

Зображення · Ideogram V3 у Rivya - це модель text-to-image для рендерингу тексту, постерних макетів і промптів для зображень із пріоритетом дизайну. Поточна вартість: 4 кредити для TURBO, 7 для BALANCED і 10 для QUALITY.

API-гайд Сторінка моделі

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

Режими

text-to-image

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Необов'язкові речі, яких слід уникати"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
rendering_speed	select	Ні	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Ні	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Ні	true	-	true, false
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Ні	-	min 0	-
negative_prompt	text	Ні	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeДоступно через APIПотрібен Files API

Зображення · Ideogram V3 Reframe зараз інтегровано в Rivya як проєкт перекадрування одного зображення з ціною за швидкістю рендерингу. Поточна ціна: 4 кредити для TURBO, 7 для BALANCED і 10 для QUALITY.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
rendering_speed	select	Ні	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Ні	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Ні	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixДоступно через APIПотрібен Files API

Зображення · Ideogram V3 Remix зараз інтегровано в Rivya як проєкт реміксу одного зображення з ціноутворенням за швидкістю рендерингу. Поточна вартість: 4 кредити для TURBO, 7 для BALANCED і 10 для QUALITY.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
rendering_speed	select	Ні	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Ні	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Ні	true	-	true, false
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Ні	-	min 0	-
strength	number	Ні	0.8	min 0.01 / max 1	-
negative_prompt	text	Ні	-	-	-

Ideogram Character

ideogram-characterДоступно через APIПотрібен Files API

Зображення · Опція для узгодженості персонажа, яка перетворює одне затверджене зображення персонажа на нові сцени, вбрання та формати. Використовуйте її, коли збереження ідентичності важливіше за широке редагування зображень і вам потрібен лише один вихідний результат за раз.

API-гайд Сторінка моделі

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

Режими

image-to-image

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
rendering_speed	select	Ні	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Ні	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	Ні	true	-	true, false
image_size	select	Ні	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Ні	-	min 0	-
negative_prompt	text	Ні	-	-	-

Seedance 2.0

seedance-2Доступно через APIТекстовий ввід готовий

Відео · Повна відеомодель Seedance 2.0 від ByteDance з явною підтримкою генерації лише з prompt, анімації на основі кадрів і мультимодальної генерації за референсами. Rivya явно зберігає задокументований розподіл ролей, щоб кадрові входи й мультимодальні референси лишалися взаємовиключними, а не зливалися в один нечіткий upload-bucket.

API-гайд Сторінка моделі

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

175

Режими

text-to-video, image-to-video, reference-to-video

API input

Текстовий ввід готовий

Входи

text

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

2500 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
seedance_scene	select	Ні	text	-	text, frames, reference
resolution	select	Ні	720p	-	480p, 720p
aspect_ratio	select	Ні	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Ні	5	min 4 / max 15	-
generate_audio	select	Ні	true	-	true, false
return_last_frame	select	Ні	false	-	false, true
web_search	select	Ні	false	-	false, true
nsfw_checker	select	Ні	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastДоступно через APIТекстовий ввід готовий

Відео · Швидша відеомодель Seedance 2.0 від ByteDance з повним розподілом сцен для генерації лише з prompt, анімації зображень на основі кадрів і мультимодальної генерації відео за референсами. Rivya явно зберігає задокументований поділ сцен, щоб входи першого/останнього кадру не змішувалися з ролями референсних зображень, відео й аудіо.

API-гайд Сторінка моделі

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

140

Режими

text-to-video, image-to-video, reference-to-video

API input

Текстовий ввід готовий

Входи

text

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

2500 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
seedance_scene	select	Ні	text	-	text, frames, reference
resolution	select	Ні	720p	-	480p, 720p
aspect_ratio	select	Ні	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Ні	5	min 4 / max 15	-
generate_audio	select	Ні	true	-	true, false
return_last_frame	select	Ні	false	-	false, true
web_search	select	Ні	false	-	false, true
nsfw_checker	select	Ні	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proДоступно через APIЧастково: потрібен Files API

Відео · Флагманська відеомодель ByteDance для генерації з тексту у відео та зображення у відео з нативною синхронізацією аудіо й відео. Кліпи 480p-1080p тривалістю 4-12s, 6 співвідношень сторін, динамічний/фіксований контроль об'єктива, опційна генерація аудіо та підтримка синхронізації губ.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

2500 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	480p, 720p, 1080p
duration	select	Ні	8	-	4, 8, 12
generate_audio	select	Ні	false	-	false, true
aspectRatio	select	Ні	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	Ні	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proДоступно через APIЧастково: потрібен Files API

Відео · Модель Seedance 1.0 Pro від ByteDance у Rivya відкрита як стандартна опція 1.0 Pro і для генерації з тексту у відео, і для генерації із зображення у відео. Вона тримає поточну сторінку узгодженою з публічними документами V1 Pro через контролі роздільної здатності, тривалості, фіксації камери, seed і перевірки безпеки.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

10000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

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

Референсне зображення: Завантажте 1 файл зображення для запусків із зображення у відео.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	480p, 720p, 1080p
duration	select	Ні	5	-	5, 10
aspect_ratio	select	Ні	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	Ні	false	-	false, true
seed	number	Ні	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Ні	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastДоступно через APIПотрібен Files API

Відео · Швидка модель ByteDance для генерації із зображення у відео. Анімує одне референсне зображення у 5s або 10s кліпи з 720p/1080p - оптимізована для швидкості, коли потрібно швидко отримати відео зі статичного кадру.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

10000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Референсне зображення: Завантажте 1 вихідне зображення, щоб анімувати його у відео.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	720p, 1080p
duration	select	Ні	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteДоступно через APIЧастково: потрібен Files API

Відео · Модель Seedance 1.0 Lite від ByteDance у Rivya відкрита як легша опція 1.0 і для генерації з тексту у відео, і для генерації із зображення у відео. Вона відповідає публічному набору параметрів V1 Lite і наразі використовує нижчу цінову драбину, ніж Seedance 1.0 Pro.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

10000 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

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

Референсне зображення: Завантажте 1 вихідне зображення для режиму зображення у відео або 2 зображення, якщо також хочете надати опційний фінальний кадр.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	480p, 720p, 1080p
duration	select	Ні	5	-	5, 10
aspect_ratio	select	Ні	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	Ні	false	-	false, true
seed	number	Ні	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Ні	true	-	true, false

HappyHorse 1.0

happyhorse-1-0Доступно через APIЧастково: потрібен Files API

Відео · Гнучка відеомодель ШІ у Rivya для text-to-video, руху з одного зображення, відео з кількома референсними зображеннями та редагування відео з однієї публічної сторінки моделі.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video, reference-to-video, video-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image, video · 10 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

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

Референсні медіа: Використовуйте до 9 зображень без відео або 1 відео з до 5 референсними зображеннями для редагування відео.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	1080p	-	720p, 1080p
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	Ні	5	min 3 / max 15	-
audio_setting	select	Ні	auto	-	auto, origin
seed	number	Ні	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoДоступно через APIЧастково: потрібен Files API

Відео · Новіша відеолінійка Wan від Alibaba з ціною за роздільністю і тривалістю. У Rivya зараз один слот моделі відкриває створення відео з тексту, створення відео із зображення та редагування відео, від 80 кредитів за генерацію.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video, video-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image, video · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Необов'язкові винятки або небажані помилки, яких слід уникати.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	720p, 1080p
duration	select	Ні	5	-	5, 10, 15
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	Ні	-	-	-
prompt_extend	select	Ні	true	-	true, false
watermark	select	Ні	false	-	false, true
audio_setting	select	Ні	auto	-	auto, origin
seed	number	Ні	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6Доступно через APIЧастково: потрібен Files API

Відео · Трирежимний варіант Wan від Alibaba у Rivya: text-to-video, image-to-video і редагування вихідного відео в одному проєкті. Він підтримує 720p/1080p, кліпи на 5-15 секунд і по одному зображенню або одному вихідному відео за раз.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video, video-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image, video · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	720p, 1080p
duration	select	Ні	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoДоступно через APIЧастково: потрібен Files API

Відео · Wan 2.5 тепер відкритий у Rivya як один спільний вхід для text-to-video та image-to-video. Поточна ціна: `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100` і `1080p_10 = 200` кредитів.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Необов'язкові винятки або сценарії збою, яких слід уникати.",
    "nsfw_checker": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	720p, 1080p
duration	select	Ні	5	-	5, 10
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	Ні	false	-	false, true
seed	number	Ні	-	min 0 / max 2147483647	-
negative_prompt	text	Ні	-	-	-
nsfw_checker	select	Ні	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboДоступно через APIЧастково: потрібен Files API

Відео · Wan 2.2 A14B Turbo тепер покриває text-to-video, image-to-video, а також відеошлях на основі зображення й аудіо у Rivya. Поточна ціна: `480p = 8` і `720p = 12` для текстових запусків або запусків із зображенням, плюс `480p = 16`, `580p = 20` і `720p = 24`, коли результат ведуть одне зображення й один аудіокліп.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video, speech-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image, audio · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Необов'язкові виключення або режими помилок, яких треба уникнути.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

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

Референсні медіа: Завантажте до 2 матеріалів. Текстовому режиму матеріали не потрібні, image-to-video використовує 1 зображення, а шлях із зображенням плюс аудіо використовує 1 зображення плюс 1 аудіокліп.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	720p	-	480p, 580p, 720p
aspect_ratio	select	Ні	16:9	-	16:9, 9:16
enable_prompt_expansion	select	Ні	false	-	false, true
seed	number	Ні	-	min 0 / max 2147483647	-
acceleration	select	Ні	none	-	none, regular
num_frames	number	Ні	80	min 40 / max 120 / step 1	-
frames_per_second	number	Ні	16	min 4 / max 60 / step 1	-
negative_prompt	text	Ні	-	-	-
num_inference_steps	number	Ні	27	min 2 / max 40 / step 1	-
guidance_scale	number	Ні	3.5	min 1 / max 10 / step 0.1	-
shift	number	Ні	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	Ні	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceДоступно через APIURL-ввід готовий

Відео · Модель Wan для заміни персонажа у відео на Rivya, коли потрібно змінити того, хто з'являється в наявному кліпі. Використовуйте одну публічну URL-адресу вихідного відео, одну публічну URL-адресу замінного зображення і рівень роздільної здатності, коли рух уже правильний, а видимий об'єкт треба замінити.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

URL-ввід готовий

Входи

url

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

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Ця модель приймає публічний URL-ввід через параметри моделі.

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
video_url	text	Ні	-	-	-
image_url	text	Ні	-	-	-
resolution	select	Ні	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3Доступно через APIПотрібен Files API

Відео · Модель image-to-video від MiniMax з рівнями якості Standard/Pro, роздільністю 768P/1080P і кліпами на 6 або 10 секунд. Відома плавнішим рухом і природними переходами зі статичних зображень.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Референсне зображення: Завантажте до 1 файлу зображення для відповідних генераційних задач.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
quality	select	Ні	standard	-	standard, pro
resolution	select	Ні	768P	-	768P, 1080P
duration	select	Ні	6	-	6, 10

Hailuo Pro

hailuo-proДоступно через APIЧастково: потрібен Files API

Відео · Старіша відеомодель Hailuo Pro від MiniMax підключена тут як одна фіксована модель Pro-рівня для text-to-video та image-to-video. Режим від зображення приймає 1 або 2 референсні зображення, друге використовується як останній кадр, а кожен запуск зараз коштує 57 кредитів.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

1500 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
prompt_optimizer	select	Ні	false	-	false, true

Hailuo Standard

hailuo-standardДоступно через APIЧастково: потрібен Files API

Відео · Старіша відеомодель Hailuo Standard від MiniMax, об'єднана тут як одна модель для text-to-video та image-to-video. Режим від зображення приймає 1 або 2 референсні зображення, друге використовується як останній кадр, а поточні перевірені публічні рівні ціни лежать у діапазоні від 12 до 50 кредитів.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

1500 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	6	-	6, 10
resolution	select	Ні	512P	-	512P, 768P
prompt_optimizer	select	Ні	false	-	false, true

Kling 3.0

kling-3-0Доступно через APIЧастково: потрібен Files API

Відео · Преміальна відеомодель Kuaishou для генерації з тексту у відео та зображення у відео, з рівнями Standard (720P) / Pro (1080P), однокадровою або багатокадровою структурою, тривалістю 3-15 с, необов'язковою генерацією аудіо й підтримкою до 2 референсних зображень.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

2000 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
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

Kling 3.0 motion-control

kling-3-0-motion-controlДоступно через APIПотрібен Files API

Відео · Новіший варіант Kling motion-control для керування одним об'єктом за допомогою одного референсного зображення та одного відео з рухом, з явним вибором джерела фону. Використовуйте його, коли потрібне перенесення руху й сильніший контроль над тим, чи сцена має походити з відео або зображення.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

Потрібен Files API

Входи

file

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

2500 символів

Референсні медіа

image, video · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Референсне зображення + відео з рухом: Завантажте рівно 1 зображення персонажа й 1 кліп руху. Використовуйте 3.0, коли потрібні і контроль орієнтації, і вибір джерела фону.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
mode	select	Ні	pro	-	std, pro
character_orientation	select	Ні	video	-	video, image
background_source	select	Ні	input_video	-	input_video, input_image

Kling 2.6

kling-2-6Доступно через APIЧастково: потрібен Files API

Відео · Відеомодель Kuaishou з необов'язковою генерацією аудіо, кліпами 5 с / 10 с і 3 співвідношеннями сторін. Сильна в людському русі та виразній анімації персонажів із природною фізикою.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

1000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

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

Референсне зображення: Завантажте до 1 файлу зображення для image-проєктів.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
sound	select	Ні	false	-	false, true
aspect_ratio	select	Ні	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlДоступно через APIПотрібен Files API

Відео · Окремий проєкт перенесення руху, який керує одним об'єктом за допомогою одного референсного зображення та одного відео з рухом. Використовуйте його, коли потрібен дешевший Kling motion-control прохід і можна обійтися без додаткових сценічних контролів Kling 3.0 motion-control.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

Потрібен Files API

Входи

file

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

2500 символів

Референсні медіа

image, video · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Референсне зображення + відео з рухом: Завантажте рівно 1 зображення персонажа й 1 кліп руху. На обох матеріалах мають бути чітко видні голова, плечі та тулуб.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
mode	select	Ні	720p	-	720p, 1080p
character_orientation	select	Ні	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proДоступно через APIЧастково: потрібен Files API

Відео · Відеомодель Kling V2.5 Turbo Pro від Kuaishou тепер підтримує і генерацію з тексту у відео, і генерацію з зображення у відео. Публічні цінові дані чітко покривають текстові й image-рівні для 5 і 10 секунд, тому Rivya напряму зіставляє її з 42 / 84 кредитами.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

2500 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Опишіть, чого відео має уникати",
    "cfg_scale": 0.5
  }
}

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

Референсні зображення: Необов'язково завантажте до 2 зображень, щоб перейти в режим генерації з зображення у відео; друге зображення зіставляється з фінальним кадром.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Ні	-	-	-
cfg_scale	number	Ні	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterДоступно через APIЧастково: потрібен Files API

Відео · Старіша відеомодель Kling V2.1 Master від Kuaishou тепер підтримує в Rivya і генерацію з тексту у відео, і зображення у відео. Поточна вартість: 160 кредитів за 5 секунд і 320 кредитів за 10 секунд.

API-гайд Сторінка моделі

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

160

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Опишіть, чого відео має уникати",
    "cfg_scale": 0.5
  }
}

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

Референсне зображення: Необов'язково завантажте одне зображення, щоб перейти в режим генерації з зображення у відео; залиште поле порожнім, щоб залишитися в текстовому режимі.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Ні	-	-	-
cfg_scale	number	Ні	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proДоступно через APIПотрібен Files API

Відео · Старіша модель Kling V2.1 Pro від Kuaishou для генерації з зображення у відео підтримує перший кадр і необов'язкове зображення фінального кадру. Поточна вартість: 50 кредитів за 5 секунд і 100 кредитів за 10 секунд.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
negative_prompt	text	Ні	-	-	-
cfg_scale	number	Ні	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardДоступно через APIПотрібен Files API

Відео · Старіша модель Kling V2.1 Standard від Kuaishou для генерації з зображення у відео. Поточна вартість: 25 кредитів за 5 секунд і 50 кредитів за 10 секунд.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Референсне зображення: Image-режим приймає до 1 файлу зображення як перший кадр.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
negative_prompt	text	Ні	-	-	-
cfg_scale	number	Ні	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proДоступно через APIПотрібен Files API

Відео · Kling AI Avatar Pro від Kuaishou - це якісніша модель аватара з мовленням, яка використовує одне портретне зображення й один аудіокліп для генерації відео з аватаром і синхронізацією губ. Rivya зараз оцінює її фіксовано: 16 кредитів за генерацію.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image, audio · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Портретне зображення й аудіо: Завантажте разом одне портретне зображення й один аудіокліп.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

Додатковий параметр моделі не потрібен.

Kling AI Avatar Standard

kling-ai-avatar-standardДоступно через APIПотрібен Files API

Відео · Kling AI Avatar Standard від Kuaishou - це модель аватара з мовленням, яка використовує одне портретне зображення й один аудіокліп для генерації відео з аватаром і синхронізацією губ. Rivya зараз оцінює її фіксовано: 8 кредитів за генерацію.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image, audio · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Портретне зображення й аудіо: Завантажте разом одне портретне зображення й один аудіокліп.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

Додатковий параметр моделі не потрібен.

Infinitalk

infinitalkДоступно через APIПотрібен Files API

Відео · Infinitalk - це модель відео з мовцем на основі портрета й аудіо. Поточна вартість рахується за роздільною здатністю та тривалістю аудіо: 480p = 3 кредити за секунду, 720p = 12 кредитів за секунду.

API-гайд Сторінка моделі

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

Режими

image-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

image, audio · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Портретне зображення й аудіо: Завантажте разом одне портретне зображення й один аудіокліп.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
resolution	select	Ні	480p	-	480p, 720p
seed	number	Ні	-	min 10000 / max 1000000	-

Runway

runwayДоступно через APIЧастково: потрібен Files API

Відео · Runway - окрема відеомодель, що підтримує і генерацію з тексту у відео, і генерацію із зображення у відео. Публічні дані про ціни наразі підтверджують лише 6 генераційних рівнів, тому Rivya тримає її на перевіреному наборі: `720p_5 = 12`, `720p_10 = 30` і `1080p_5 = 30`.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

1800 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "Залиште порожнім, щоб вимкнути водяний знак"
  }
}

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

Референсне зображення: За бажанням завантажте одне зображення, щоб перейти в режим зображення у відео; залиште порожнім, щоб лишитися в текстовому режимі.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
duration	select	Ні	5	-	5, 10
quality	select	Ні	720p	-	720p, 1080p
aspectRatio	select	Ні	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	Ні	-	-	-

Runway Aleph

runway-alephДоступно через APIПотрібен Files API

Відео · Проєкт трансформації вихідного відео для переробки наявного кліпу в новий візуальний результат. Використовуйте Aleph, коли рух походить із вашого вхідного відеоматеріалу, а креативний напрям задає промпт, із фіксованою ціною 90 кредитів.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

Потрібен Files API

Входи

file

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

5000 символів

Референсні медіа

video, image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вхідні медіа: Завантажте вихідний кліп, який Aleph має трансформувати. Додайте одне опційне статичне зображення лише тоді, коли потрібне додаткове спрямування стилю або об'єкта.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	Ні	-	-	-
seed	number	Ні	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoДоступно через APIПотрібен Files API

Відео · Окремий проєкт переписування вихідного відео для переведення одного наявного кліпу в новий візуальний напрям. Використовуйте його, коли промпт має трансформувати сам матеріал, а не просто зробити експорт чіткішим.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

Потрібен Files API

Входи

file

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

Референсні медіа

video · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вхідне відео: Завантажте один короткий вихідний кліп, який потрібно трансформувати. Цей варіант переписує матеріал, а не просто покращує його.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
watermark	text	Ні	-	-	-

Grok Imagine Video

grok-imagine-videoДоступно через APIЧастково: потрібен Files API

Відео · Відеомодель xAI з творчими режимами Fun/Normal/Spicy і 5 співвідношеннями сторін. Унікальні стильові пресети для різних творчих тонів — від грайливого до кінематографічного й зухвалого.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

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

Референсне зображення: Завантажте до 1 файлу зображення для відповідних генераційних задач.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
mode	select	Ні	normal	-	fun, normal, spicy
duration	number	Ні	6	min 6 / max 30 / step 1	-
resolution	select	Ні	480p	-	480p, 720p
aspect_ratio	select	Ні	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proДоступно через APIЧастково: потрібен Files API

Відео · Преміальний рівень Sora 2 з режимами якості Standard/High, кліпами 10s/15s і видаленням водяного знака. Покращена деталізація, освітлення й точність руху для професійного відеовиробництва.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

10000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
size	select	Ні	-	-	standard, high
n_frames	select	Ні	10	-	10, 15
aspect_ratio	select	Ні	landscape	-	landscape, portrait
remove_watermark	select	Ні	false	-	false, true
upload_method	select	Ні	s3	-	s3, oss

Sora 2

sora-2Доступно через APIЧастково: потрібен Files API

Відео · Відеомодель OpenAI для text-to-video та image-to-video з реалістичною симуляцією світу, синхронізованим аудіо, кліпами 10s/15s, альбомним/портретним виводом і опційним видаленням водяного знака.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

10000 символів

Референсні медіа

image · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
n_frames	select	Ні	10	-	10, 15
aspect_ratio	select	Ні	landscape	-	landscape, portrait
remove_watermark	select	Ні	false	-	false, true
upload_method	select	Ні	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerДоступно через APIURL-ввід готовий

Відео · Модель постобробки Sora для видалення водяного знака у Rivya, призначена для готових публічних посилань Sora. Використовуйте її після завершення відео, коли залишилося лише прибрати водяний знак і вибрати доставку через S3 або OSS.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

URL-ввід готовий

Входи

url

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

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Ця модель приймає публічний URL-ввід через параметри моделі.

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
video_url	text	Так	-	-	-
upload_method	select	Так	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleДоступно через APIПотрібен Files API

Відео · Відеоапскейлер Topaz рівня фінальної доставки в Rivya для затверджених кліпів, яким бракує лише більшої чіткості на експорті. Використовуйте його, коли кадр, рух і таймінг уже правильні, а залишкова проблема полягає в роздільній здатності або різкості фінального файлу.

API-гайд Сторінка моделі

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

Режими

video-to-video

API input

Потрібен Files API

Входи

file

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

Референсні медіа

video · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вихідне відео: Завантажте 1 вихідний кліп, який хочете зберегти. Цей варіант покращує чіткість доставки, а не змінює кадр.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
upscale_factor	select	Ні	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityДоступно через APIЧастково: потрібен Files API

Відео · Варіант Google Veo 3.1 з пріоритетом якості для преміальної генерації text-to-video та генерації на основі зображень. Вища візуальна точність, сильніший реалізм руху та фонове аудіо за замовчуванням роблять його вищим рівнем Veo у Rivya.

API-гайд Сторінка моделі

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

150

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Необов'язковий текст водяного знака",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	16:9	-	16:9, 9:16, Auto
watermark	text	Ні	-	-	-
seeds	number	Ні	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Ні	true	-	true, false

Veo3.1 Fast

veo3-1-fastДоступно через APIЧастково: потрібен Files API

Відео · Швидкий варіант Google Veo 3.1 з підтримкою трьох режимів: text-to-video, image-to-video і reference-to-video. До 3 референсних зображень, нативне аудіо та керування співвідношенням сторін з урахуванням режиму роблять його корисним для швидких кінематографічних кліпів.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video, reference-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 3 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "Необов'язковий текст водяного знака",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
generationType	select	Ні	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	Ні	16:9	-	16:9, 9:16, Auto
watermark	text	Ні	-	-	-
seeds	number	Ні	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Ні	true	-	true, false

Veo3.1 Lite

veo3-1-liteДоступно через APIЧастково: потрібен Files API

Відео · Найдешевший варіант Google Veo 3.1. Зараз Rivya відкриває лише найменший стабільний набір: text-to-video та image-to-video за фіксовані `10` кредитів за генерацію.

API-гайд Сторінка моделі

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

Режими

text-to-video, image-to-video

API input

Частково: потрібен Files API

Входи

text, file

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

5000 символів

Референсні медіа

image · 2 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Необов'язковий текст водяного знака",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

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

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
aspectRatio	select	Ні	16:9	-	16:9, 9:16, Auto
watermark	text	Ні	-	-	-
seeds	number	Ні	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Ні	true	-	true, false

Suno Music

suno-musicДоступно через APIТекстовий ввід готовий

Аудіо · Suno Music - модель Rivya для перетворення тексту на музику, яка робить із короткого брифу першу чернетку пісні з вокалом або без нього. Вона зберігає фіксовану вхідну ціну `12` кредитів і показує `Extend Music` як наступний крок після успішного треку.

API-гайд Сторінка моделі

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

Режими

text-to-audio

API input

Текстовий ввід готовий

Входи

text

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

500 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
model	select	Ні	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	Ні	false	-	false, true

Suno Sounds

suno-soundsДоступно через APIТекстовий ввід готовий

Аудіо · Suno Sounds - легка модель Rivya для перетворення prompt у звук: атмосферні петлі, фоновий звук і короткі звукові ескізи. Вона зберігає задокументовану фіксовану ціну `3` кредити за генерацію і дає змогу успішним результатам перейти у `Vocal Separation`.

API-гайд Сторінка моделі

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

Режими

text-to-audio

API input

Текстовий ввід готовий

Входи

text

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

500 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
model	select	Ні	V5	-	V5, V5_5
soundLoop	select	Ні	false	-	false, true
soundTempo	number	Ні	-	min 1 / max 300 / step 1	-
soundKey	select	Ні	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsДоступно через APIТекстовий ввід готовий

Аудіо · Suno Lyrics - модель Rivya для генерації текстів пісень, яка перетворює одну тему або настрій на слова пісні за фіксованою ціною `1` кредит за запит.

API-гайд Сторінка моделі

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

Режими

text-to-audio

API input

Текстовий ввід готовий

Входи

text

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

200 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3Доступно через APIТекстовий ввід готовий

Аудіо · Модель ElevenLabs для багатоспікерного діалогу в Rivya. Вона створена для генерації мовлення за ролями, з окремими голосами для персонажів, контролями стабільності та темпом, готовим для подкастів, інтерв'ю й сцен із персонажами.

API-гайд Сторінка моделі

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

Режими

dialogue-to-audio

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
default_voice	select	Ні	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	Ні	0.5	-	0, 0.5, 1
language_code	text	Ні	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Доступно через APIТекстовий ввід готовий

Аудіо · Швидка модель ElevenLabs для перетворення тексту на мовлення в Rivya. Завдяки голосовій генерації з низькою затримкою та регульованій стабільності, схожості, стилю й швидкості вона створена для швидких чернеток озвучення та інтерактивних проєктів синтезу мовлення.

API-гайд Сторінка моделі

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

Режими

text-to-speech

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Опційний контекст перед цим рядком",
    "next_text": "Опційний контекст після цього рядка",
    "language_code": "Опційний код локалі на кшталт en або zh"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
voice	select	Так	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Ні	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Ні	0.75	min 0 / max 1 / step 0.05	-
style	number	Ні	0	min 0 / max 1 / step 0.05	-
speed	number	Ні	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Ні	false	-	false, true
previous_text	text	Ні	-	-	-
next_text	text	Ні	-	-	-
language_code	text	Ні	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Доступно через APIТекстовий ввід готовий

Аудіо · Багатомовна модель ElevenLabs для перетворення тексту на мовлення в Rivya, що підтримує близько 30 мов з автоматичним визначенням. Це сильніша опція для локалізації, міжмовної подачі та природніших багатомовних озвучень.

API-гайд Сторінка моделі

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

Режими

text-to-speech

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
voice	select	Так	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Ні	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Ні	0.75	min 0 / max 1 / step 0.05	-
style	number	Ні	0	min 0 / max 1 / step 0.05	-
speed	number	Ні	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Ні	false	-	false, true
previous_text	text	Ні	-	-	-
next_text	text	Ні	-	-	-
language_code	text	Ні	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2Доступно через APIТекстовий ввід готовий

Аудіо · Модель ElevenLabs для перетворення тексту на звук у Rivya: короткі ефекти, переходи й атмосферні петлі. Генеруйте аудіокліпи тривалістю 0.5–22 секунди з регульованим впливом промпту, режимом зациклення та 19 форматами виводу для монтажних, продуктових або ігрових проєктів.

API-гайд Сторінка моделі

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

Режими

text-to-audio

API input

Текстовий ввід готовий

Входи

text

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

5000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

key	Тип	Обов'язково	За замовчуванням	Діапазон	Опції
loop	select	Ні	false	-	false, true
duration_seconds	number	Ні	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	Ні	0.3	min 0 / max 1 / step 0.05	-
output_format	select	Ні	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationДоступно через APIПотрібен Files API

Аудіо · Модель ElevenLabs для очищення аудіо та ізоляції голосу в Rivya. Завантажте один запис, щоб ізолювати вокал, прибрати фоновий шум і очистити мовленнєве аудіо перед редагуванням або публікацією.

API-гайд Сторінка моделі

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

Режими

audio-to-audio

API input

Потрібен Files API

Входи

file

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

Референсні медіа

audio · 1 file(s)

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

Для цієї моделі не показано виконуваний приклад Public API.

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

Вихідне аудіо: Завантажте один аудіофайл, і Rivya ізолює та очистить цільову доріжку.

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Режими на основі файлів потребують /api/v1/files, перш ніж їх можна показати як повні приклади, готові для API. Files API

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.5

gpt-5-5-chatДоступно через APIТекстовий ввід готовий

Чат · Просунута чат-модель GPT від OpenAI у Rivya для складного міркування, аналізу з урахуванням зображень, дослідницького синтезу та структурованого письма, коли брифу потрібно більше простору.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень мають використовувати значення file_id з Files API.

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.4

gpt-5-4-chatДоступно через APIТекстовий ввід готовий

Чат · Вищий рівень чат-моделі ШІ від OpenAI у Rivya з сильнішою роботою зі структурованими вхідними даними, контролем міркування та розмовними проєктами, орієнтованими на інструменти, для складнішого аналізу й письма.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.4 Codex

gpt-5.4-codex-chatДоступно через APIТекстовий ввід готовий

Чат · Вищий рівень моделі Codex від OpenAI у Rivya із сильнішим програмуванням, структурованим міркуванням і співпрацею, орієнтованою на інструменти, для вимогливих проєктів розробки масштабу репозиторію.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.3 Codex

gpt-5-3-codex-chatДоступно через APIТекстовий ввід готовий

Чат · Найновіша й найпотужніша модель Codex від OpenAI у Rivya. Вона поєднує передову генерацію коду з глибшим агентним міркуванням для найвимогливіших проєктів розробки.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.2

gpt-5-2-chatДоступно через APIТекстовий ввід готовий

Чат · Флагманська чат-модель ШІ від OpenAI у Rivya з просунутим міркуванням, підтримкою зору до 6 зображень і контекстним вікном 20K символів. Це сильний універсальний варіант GPT для досліджень, планування, письма й аналізу з урахуванням зображень.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.2 Codex

gpt-5-2-codex-chatДоступно через APIТекстовий ввід готовий

Чат · Просунутіша модель Codex від OpenAI у Rivya із сильнішим міркуванням для складних інженерних завдань. Вона оптимізована для довгострокового агентного програмування, архітектурних рішень і більших рефакторів, де простої генерації коду недостатньо.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5.1 Codex

gpt-5-1-codex-chatДоступно через APIТекстовий ввід готовий

Чат · Оновлена модель Codex від OpenAI у Rivya з кращою точністю коду та сильнішим міркуванням для агентних завдань програмування. Вона зберігає той самий проєкт із довгим виводом і розумінням репозиторію, але краще справляється з багатофайловими рефакторами та безпечнішими правками коду.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

GPT-5 Codex

gpt-5-codex-chatДоступно через APIТекстовий ввід готовий

Чат · Спеціалізована для коду модель GPT-5 Codex від OpenAI у Rivya для налагодження, планування реалізації, рефакторів і технічного розв'язання проблем із підтримкою зору.

API-гайд Сторінка моделі

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

Режими

responses

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Gemini 3.1 Pro

gemini-3-1-pro-chatДоступно через APIТекстовий ввід готовий

Чат · Найновіша й найпотужніша чат-модель Gemini від Google у Rivya. Завдяки міркуванню верхнього рівня, зору та точному виконанню інструкцій це найсильніший варіант Gemini для вимогливих аналітичних і творчих завдань.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Gemini 3 Pro

gemini-3-pro-chatДоступно через APIТекстовий ввід готовий

Чат · Глибша чат-модель Gemini від Google у Rivya. Завдяки сильнішому міркуванню, ніж у Gemini 2.5 Pro, і підтримці зору вона краще підходить для дослідницького синтезу, технічного письма та виваженішого мультимодального аналізу.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Gemini 3 Flash

gemini-3-flash-chatДоступно через APIТекстовий ввід готовий

Чат · Швидка чат-модель ШІ нового покоління від Google у Rivya. З нижчими токенними витратами, ніж у Gemini 2.5 Flash, і сильнішим міркуванням вона створена для масового мультимодального чату, розбору скриншотів і швидкої роботи асистента.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Gemini 2.5 Pro

gemini-2-5-pro-chatДоступно через APIТекстовий ввід готовий

Чат · Просунутіша чат-модель Gemini від Google у Rivya. Вона міркує сильніше за Flash, підтримує зір і контекст 20K, тому краще підходить для дослідницького синтезу, аналізу документів і структурованого письма за 2 кредити.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Gemini 2.5 Flash

gemini-2-5-flash-chatДоступно через APIТекстовий ввід готовий

Чат · Найшвидша й найдоступніша чат-модель ШІ від Google у Rivya. За 1 кредит за використання і з підтримкою зору до 6 зображень вона підходить для швидких запитань і відповідей, первинних резюме, розбору скриншотів і щоденної ШІ-допомоги.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text, file

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Параметри

Додатковий параметр моделі не потрібен.

Claude Opus 4.7

claude-opus-4-7-chatДоступно через APIТекстовий ввід готовий

Чат · Флагманська чат-модель Claude від Anthropic у Rivya для глибокого міркування, уважного синтезу, виконавчого письма та текстової роботи з високим впливом.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Claude Opus 4.6

claude-opus-4-6-chatДоступно через APIТекстовий ввід готовий

Чат · Флагманська ШІ-модель Claude для чату від Anthropic у Rivya. Вона створена для глибокого міркування, складного аналізу й якісного письма у вимогливих проєктах із високими ставками.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Claude Sonnet 4.6

claude-sonnet-4-6-chatДоступно через APIТекстовий ввід готовий

Чат · Збалансована ШІ-модель Claude для чату від Anthropic у Rivya. Вона зберігає сильне довгоформатне міркування й уважний аналіз для контентних, дослідницьких і кодових проєктів без переходу до витрат рівня Opus.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Claude Opus 4.5

claude-opus-4-5-chatДоступно через APIТекстовий ввід готовий

Чат · Флагманська ШІ-модель Claude для чату від Anthropic у Rivya. Вона вирізняється глибоким міркуванням, складним аналізом і письмом експертного рівня, тому є преміумвибором для критично важливих ШІ-задач.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Claude Sonnet 4.5

claude-sonnet-4-5-chatДоступно через APIТекстовий ввід готовий

Чат · Збалансована ШІ-модель Claude для чату від Anthropic у Rivya. Вона сильна в нюансованому письмі, уважному аналізі й відповідях із фокусом на безпеку, тому є сильним варіантом Claude для створення контенту та досліджень.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Claude Haiku 4.5

claude-haiku-4-5-chatДоступно через APIТекстовий ввід готовий

Чат · Легка ШІ-модель Claude для чату від Anthropic у Rivya. Вона налаштована на швидкість, економну вартість і стабільну щоденну продуктивність чату в частих проєктах, де потрібен тон Claude без преміумвитрат.

API-гайд Сторінка моделі

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

Режими

chat-completion

API input

Текстовий ввід готовий

Входи

text

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

20000 символів

Референсні медіа

Запит

POST /api/v1/generations

Автентифікація

Bearer API key

Idempotency-Key

Рекомендовано

Тіло

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

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

Результат

Відповідь створення повертає публічний ID задачі. Опитуйте GET /api/v1/generations/{taskId}, доки status не стане succeeded або failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API підтримує non-streaming і SSE streaming ходи в Public API v1. Вкладення зображень не підтримуються для цієї моделі чату.

Параметри

Додатковий параметр моделі не потрібен.

Довідник API моделей

Як читати цей довідник

Патерн запиту

Динамічний довідник моделей

Використовуйте цей довідник із налагоджувачем

Z-Image

Тіло

Параметри

Nano Banana 2

Тіло

Параметри

Nano Banana Pro

Тіло

Параметри

Nano Banana

Тіло

Параметри

GPT Image 2

Тіло

Параметри

GPT Image 1.5

Тіло

Параметри

4o Image

Тіло

Параметри

Seedream 5.0 Lite

Тіло

Параметри

Seedream 4.5

Тіло

Параметри

Seedream 4.0

Тіло

Параметри

Seedream 3.0

Тіло

Параметри

Grok Imagine

Тіло

Параметри

Flux 2 Pro

Тіло

Параметри

Flux 2 Flex

Тіло

Параметри

Flux Kontext Max

Тіло

Параметри

Flux Kontext Pro

Тіло

Параметри

Qwen2 Image

Тіло

Параметри

Qwen Image

Тіло

Параметри

Midjourney

Тіло

Параметри

Recraft Remove Background

Тіло

Параметри

Recraft Crisp Upscale

Тіло

Параметри

Wan 2.7 Image Pro

Тіло

Параметри

Wan 2.7 Image

Тіло

Параметри

Google Imagen4 Ultra

Тіло

Параметри

Google Imagen4

Тіло

Параметри