MiniMax H3 API

MiniMax H3 API

MiniMax H3 делает короткие ролики со звуком длиной от 5 до 15 секунд. Сцену можно описать словами, оживить готовую картинку или собрать видео по референсам: показать персонажа и предметы на фото, движение на видео, голос и ритм в аудио. Есть две модели: H3 (768P или 2K) и старшая H3 Max (480p, 768P или 1080p). Подходит для рекламных роликов товара, анимации обложек и иллюстраций, тизеров и вертикальных видео для соцсетей.

Основные сценарии:

• Видео из текста - без входных файлов (text).
• Видео из изображения - картинка становится первым кадром (image), при желании можно задать и последний кадр.
• Видео по референсам - до 9 изображений, до 3 видео и до 3 аудио (reference).

Каждый вызов создаёт асинхронную операцию. Сохраните id из ответа и проверяйте статус отдельным запросом.

Создание операции

• Endpoint: POST /api/v1/operations
• Авторизация: Authorization: Bearer brth_...
• Выполнение асинхронное: запрос сразу возвращает id и стартовый статус queued.

Режим выбирается параметром generation_type, модель - параметром model:

• text - видео по описанию, формат кадра задаёт aspect_ratio;
• image - видео из картинки image, пропорции берутся из неё; с use_last_image: true и last_image ролик закончится заданным кадром;
• reference - видео по референсам reference_images, reference_videos и reference_audios, формат кадра задаёт aspect_ratio.

Тело запроса

{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "text",
    "model": "h3",
    "prompt": "...",
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration": 5
  }
}

• tool - slug нейросети, всегда "minimax-h3".
• input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.

Параметры

В режиме reference нужен хотя бы один файл в reference_images или reference_videos. Запрос только с аудио вернёт ошибку 400 validation_error.

Для всех файлов нужны внешние http/https ссылки, которые открываются без авторизации.

Примеры запросов

Видео из текста, H3 768P

Самый дешёвый вариант H3: 10 ₽ за секунду.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "text",
    "model": "h3",
    "prompt": "Утренний рынок в приморском городе: продавец рыбы поднимает свежую дораду и говорит покупателю по-русски: «Только с лодки, ещё утром плавала!» Над прилавками кружат чайки, тёплый рассветный свет",
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration": 5
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'text',
      model: 'h3',
      prompt: 'Утренний рынок в приморском городе: продавец рыбы поднимает свежую дораду и говорит покупателю по-русски: «Только с лодки, ещё утром плавала!» Над прилавками кружат чайки, тёплый рассветный свет',
      aspect_ratio: '16:9',
      resolution: '768p',
      duration: 5,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'text',
            'model': 'h3',
            'prompt': 'Утренний рынок в приморском городе: продавец рыбы поднимает свежую дораду и говорит покупателю по-русски: «Только с лодки, ещё утром плавала!» Над прилавками кружат чайки, тёплый рассветный свет',
            'aspect_ratio': '16:9',
            'resolution': '768p',
            'duration': 5,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео из текста, H3 Max 1080p

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "text",
    "model": "h3_max",
    "prompt": "Детектив в плаще оборачивается на мокрой ночной улице, неоновые вывески отражаются в лужах, камера медленно обходит его по дуге",
    "aspect_ratio": "21:9",
    "resolution": "1080p",
    "duration": 10
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'text',
      model: 'h3_max',
      prompt: 'Детектив в плаще оборачивается на мокрой ночной улице, неоновые вывески отражаются в лужах, камера медленно обходит его по дуге',
      aspect_ratio: '21:9',
      resolution: '1080p',
      duration: 10,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'text',
            'model': 'h3_max',
            'prompt': 'Детектив в плаще оборачивается на мокрой ночной улице, неоновые вывески отражаются в лужах, камера медленно обходит его по дуге',
            'aspect_ratio': '21:9',
            'resolution': '1080p',
            'duration': 10,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео из изображения

Картинка из image станет первым кадром, пропорции ролика берутся из неё.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "image",
    "model": "h3_max",
    "prompt": "Девушка дочитывает письмо, улыбается и поднимает взгляд, листья медленно падают, камера плавно приближается, мягкий осенний свет",
    "image": "https://cdn.example.com/first-frame.png",
    "resolution": "480p",
    "duration": 5
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'image',
      model: 'h3_max',
      prompt: 'Девушка дочитывает письмо, улыбается и поднимает взгляд, листья медленно падают, камера плавно приближается, мягкий осенний свет',
      image: 'https://cdn.example.com/first-frame.png',
      resolution: '480p',
      duration: 5,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'image',
            'model': 'h3_max',
            'prompt': 'Девушка дочитывает письмо, улыбается и поднимает взгляд, листья медленно падают, камера плавно приближается, мягкий осенний свет',
            'image': 'https://cdn.example.com/first-frame.png',
            'resolution': '480p',
            'duration': 5,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео из изображения с последним кадром

Ролик начнётся с image и закончится last_image. Подходит для превращений, пролётов и плавных переходов.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "image",
    "model": "h3",
    "prompt": "Бумажный кораблик плывёт по ручью и выплывает в широкую реку, камера следует за ним",
    "image": "https://cdn.example.com/first-frame.jpg",
    "use_last_image": true,
    "last_image": "https://cdn.example.com/last-frame.jpg",
    "resolution": "2k",
    "duration": 10
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'image',
      model: 'h3',
      prompt: 'Бумажный кораблик плывёт по ручью и выплывает в широкую реку, камера следует за ним',
      image: 'https://cdn.example.com/first-frame.jpg',
      use_last_image: true,
      last_image: 'https://cdn.example.com/last-frame.jpg',
      resolution: '2k',
      duration: 10,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'image',
            'model': 'h3',
            'prompt': 'Бумажный кораблик плывёт по ручью и выплывает в широкую реку, камера следует за ним',
            'image': 'https://cdn.example.com/first-frame.jpg',
            'use_last_image': True,
            'last_image': 'https://cdn.example.com/last-frame.jpg',
            'resolution': '2k',
            'duration': 10,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео по референсам-изображениям

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "reference",
    "model": "h3",
    "prompt": "Пасечник с первой картинки стоит на пасеке среди голубых ульев и держит банку мёда со второй картинки этикеткой к камере, тёплый вечерний свет",
    "reference_images": [
      "https://cdn.example.com/reference-1.jpg",
      "https://cdn.example.com/reference-2.png"
    ],
    "aspect_ratio": "9:16",
    "resolution": "768p",
    "duration": 5
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'reference',
      model: 'h3',
      prompt: 'Пасечник с первой картинки стоит на пасеке среди голубых ульев и держит банку мёда со второй картинки этикеткой к камере, тёплый вечерний свет',
      reference_images: [
        'https://cdn.example.com/reference-1.jpg',
        'https://cdn.example.com/reference-2.png',
      ],
      aspect_ratio: '9:16',
      resolution: '768p',
      duration: 5,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'reference',
            'model': 'h3',
            'prompt': 'Пасечник с первой картинки стоит на пасеке среди голубых ульев и держит банку мёда со второй картинки этикеткой к камере, тёплый вечерний свет',
            'reference_images': [
                'https://cdn.example.com/reference-1.jpg',
                'https://cdn.example.com/reference-2.png',
            ],
            'aspect_ratio': '9:16',
            'resolution': '768p',
            'duration': 5,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Видео по референсам: изображение, видео и аудио

Секунды референс-видео оплачиваются по той же ставке, что и секунды ролика.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "minimax-h3",
  "input": {
    "generation_type": "reference",
    "model": "h3",
    "prompt": "Девушка с картинки танцует на крыше на закате, повторяет движения из видео и попадает в ритм музыки из аудио",
    "reference_images": [
      "https://cdn.example.com/reference-1.jpg"
    ],
    "reference_videos": [
      "https://cdn.example.com/motion-1.mp4"
    ],
    "reference_audios": [
      "https://cdn.example.com/music-1.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration": 5
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'minimax-h3',
    input: {
      generation_type: 'reference',
      model: 'h3',
      prompt: 'Девушка с картинки танцует на крыше на закате, повторяет движения из видео и попадает в ритм музыки из аудио',
      reference_images: [
        'https://cdn.example.com/reference-1.jpg',
      ],
      reference_videos: [
        'https://cdn.example.com/motion-1.mp4',
      ],
      reference_audios: [
        'https://cdn.example.com/music-1.mp3',
      ],
      aspect_ratio: '16:9',
      resolution: '768p',
      duration: 5,
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'minimax-h3',
        'input': {
            'generation_type': 'reference',
            'model': 'h3',
            'prompt': 'Девушка с картинки танцует на крыше на закате, повторяет движения из видео и попадает в ритм музыки из аудио',
            'reference_images': [
                'https://cdn.example.com/reference-1.jpg',
            ],
            'reference_videos': [
                'https://cdn.example.com/motion-1.mp4',
            ],
            'reference_audios': [
                'https://cdn.example.com/music-1.mp3',
            ],
            'aspect_ratio': '16:9',
            'resolution': '768p',
            'duration': 5,
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Примеры ответов

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "minimax-h3",
  "cost": 50,
  "balance_after": 450,
  "created_at": "2026-10-02T19:50:36.746941+00:00"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "minimax-h3",
  "cost": 50,
  "created_at": "2026-10-02T19:50:36.746941+00:00",
  "completed_at": "2026-10-02T19:51:25.834556+00:00",
  "result": {
    "type": "video",
    "urls": [
      "https://storage.bratuha.ru/results/minimax-h3/video-1.mp4"
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "minimax-h3",
  "cost": 50,
  "created_at": "2026-10-02T19:50:36.746941+00:00",
  "completed_at": "2026-10-02T19:51:40.220391+00:00",
  "result": null,
  "error_message": "Ваш запрос не прошел модерацию."
}

Проверка статуса

Сохраните id из ответа на создание и запрашивайте статус операции по нему:

GET /api/v1/operations/{id}

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

async function waitForResult(id: string) {
  while (true) {
    const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
      headers: { Authorization: 'Bearer brth_ваш_ключ' },
    })
    const operation = await response.json()
    if (operation.status === 'completed' || operation.status === 'failed') {
      return operation
    }
    await new Promise((resolve) => setTimeout(resolve, 10000))
  }
}

Статус меняется с queued на processing, а затем на completed или failed. В наших проверках ролики 768P и 480p были готовы за 40-130 секунд, 2K - около 3 минут. Опрашивать одну операцию можно не чаще раза в секунду, для видео разумный интервал - 10 секунд.

Формат результата

После завершения в result приходит:

{
  "type": "video",
  "urls": [
    "https://storage.bratuha.ru/results/minimax-h3/video-1.mp4"
  ]
}

• type - всегда "video".
• urls - массив с одной ссылкой на ролик в формате MP4 со звуковой дорожкой.

Размеры кадра в наших проверках: H3 768P 16:9 - 1344 × 768, H3 2K 9:16 - 1456 × 2544, H3 Max 480p 16:9 - 832 × 480. Частота - 24 кадра в секунду.

Ценообразование

Цена считается по секундам итогового ролика (duration) и зависит от модели и разрешения:

В режиме reference с видео к секундам ролика добавляются секунды референс-видео по той же ставке: длина каждого видео округляется вверх до целой секунды, затем всё складывается. Референсные изображения и аудио цену не меняют.

Стоимость списывается при создании операции и приходит в поле cost ответа. Если длительность референс-видео не удалось определить, операция не создаётся и деньги не списываются.

Ограничения и практические заметки

• Передайте UUID в заголовке Idempotency-Key: повтор одного запроса в течение 24 часов вернёт исходную операцию без повторного списания. Повтор без этого заголовка создаёт новую операцию.
• Передайте max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.
• Все операции асинхронные: сначала приходит queued, результат забирается по id.
• Файлы передаются только внешними http/https ссылками, которые открываются без авторизации. Изображения - только JPG, JPEG, PNG или WebP.
• duration - только целое число от 5 до 15. Дробное значение, например 7.5, вернёт 400 validation_error.
• Разрешение должно подходить модели: 2k только для h3, 480p и 1080p только для h3_max.
• Поля другого режима не учитываются: image, use_last_image и last_image работают только в image, файлы reference_* - только в reference, aspect_ratio - в text и reference.
• В режиме reference аудио не может быть единственным референсом - добавьте хотя бы одно изображение или видео. Речь из референс-аудио модель может повторить в ролике дословно.
• Референс-видео увеличивают цену: платится каждая их секунда, даже если итоговый ролик короче. Обрезайте видео до нужного фрагмента заранее.
• Задания и файлы проходят модерацию. Если запрос её не прошёл, операция завершится со статусом failed и сообщением «Ваш запрос не прошел модерацию.»