Rivya AI Docs
Сторінки API моделей

API-інтеграція для Hailuo Standard

Використовуйте 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 types
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.