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

Интеграция Hailuo Standard API

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

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

hailuo-standard

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

text, file

Files API

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

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

30

Возможность

Видео

Биллинг

FIXED

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

1500 символов

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

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

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

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

КлючТипОбязательноПо умолчаниюДиапазонВариантыОписание
durationselectНет6-6, 10Длительность
resolutionselectНет512P-512P, 768PРазрешение
prompt_optimizerselectНетfalse-false, trueПозволяет Hailuo переписать и оптимизировать ваш запрос перед генерацией. Отключите его, если хотите, чтобы запуск оставался ближе к исходной формулировке.

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

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

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

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

Макс. файлов

2

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

image

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

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

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

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

{
  "model": "hailuo-standard",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

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

{
  "model": "hailuo-standard",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_hailuo_standard_example",
  "status": "queued",
  "model": "hailuo-standard",
  "reserved_credits": 30,
  "final_credits": 0,
  "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.