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

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

ID моделі API

happyhorse-1-1

Входи

text, file

Files API

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

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

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

Можливість

Відео

Білінг

METERED

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

5000 символів

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

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

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

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

Ключ	Тип	Обов'язково	За замовчуванням	Діапазон	Опції	Опис
resolution	select	Ні	1080p	-	720p, 1080p	Вибрана роздільна здатність визначає посекундну ставку кредитів.
aspect_ratio	select	Ні	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Використовується для запусків лише за промптом і з кількома референсами; запуск з одним зображенням наслідує перший кадр.
duration	number	Ні	5	min 3 / max 15 / step 1	-	Виберіть цілочисельну тривалість вихідного відео від 3 до 15 секунд.

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

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

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

Перший кадр або референсні зображення: Завантажте одне зображення JPEG, PNG або WebP для анімації першого кадру або 2–9 зображень для відео під керуванням референсів. Розмір кожного файла може становити до 20 МБ.

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

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

image

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

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

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

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

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

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

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_happyhorse_1_1_example",
  "status": "queued",
  "model": "happyhorse-1-1",
  "reserved_credits": 145,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

API-інтеграція для HappyHorse 1.1