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

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

ID модели API

minimax-h3

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

text, file

Files API

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

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

Кредиты зависят от входных данных и настроек. Проверьте оценку перед генерацией. Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Видео

Биллинг

METERED

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

7000 символов

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

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

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	minimax-h3	Используйте minimax-h3 как ID модели API.
prompt	string	Да	-	Максимум 7000 символов для этой модели.
params	object	Нет	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

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

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
seedance_scene	select	Нет	text	-	text, frames, reference	Выберите режим входных данных MiniMax до загрузки; у текста, кадров и референсов разные требования.
resolution	select	Нет	2K	-	768P, 2K	Выбранный режим задаёт ставку за секунду, применяемую к результату и проверенному времени входного видео.
aspect_ratio	select	Нет	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Адаптивный вариант доступен в режиме референсов, но не в текстовом. Режим кадров использует геометрию изображения и не отправляет эту настройку.
minimax_single_frame_role	select	Нет	first	-	first, last	Да. Для одного изображения выберите, будет оно начальным или конечным кадром. Два изображения расположите как начало, затем конец.
duration	number	Нет	6	min 4 / max 15 / step 1	-	Выберите целую длительность результата от 4 до 15 секунд.

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

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

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

Направляющие кадры или мультимодальные референсы: Сценарий кадров принимает 1 или 2 изображения JPEG, PNG или WebP размером до 30 MB каждое. Сценарий референсов принимает до 9 таких изображений, 3 видео MP4/MOV размером до 50 MB и длительностью 2–15 секунд каждое и 3 аудиофайлов MP3/WAV размером до 15 MB и длительностью 2–15 секунд каждый; общая длительность видео и аудио отдельно ограничена 15 секундами, все медиа — 15 файлами, а аудио нельзя использовать отдельно.

Макс. файлов

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

image, video, audio

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

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

kind	Макс. размер	MIME-типы
image	30 MB	image/jpeg, image/png, image/webp
video	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

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

{
  "model": "minimax-h3",
  "prompt": "Камера медленно обходит флакон продукта на столе в студии.",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

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

{
  "model": "minimax-h3",
  "prompt": "Камера медленно обходит флакон продукта на столе в студии.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_minimax_h3_example",
  "status": "queued",
  "model": "minimax-h3",
  "reserved_credits": 78,
  "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.

Интеграция MiniMax H3 API