MiniMax H3 Max

Создавайте видео длительностью от 5 секунд в 480P или 768P по тексту либо одному-двум кадрам. Оплата посекундная.

• Асинхронная обработка: запрос создания возвращает ID задачи. Видео будет доступно после её успешного завершения.
• Три варианта ввода: только текст, первый кадр либо первый и последний кадры. Референсы и aspect_ratio не поддерживаются.
• Два разрешения: 480P и 768P по умолчанию. Значения пишутся заглавными буквами.
• Оплата за секунду видео по тарифу выбранного разрешения. Минимальная duration — 5 секунд. Задача, завершившаяся ошибкой, не оплачивается.

Открывает модель в API Explorer. Введите свой API-ключ BeatAPI, чтобы создать задачу. Это настоящий запрос: его стоимость спишется с вашего баланса.

Идентификаторы моделей

Пять моделей MiniMax H3 используют один адрес API, но принимают разные входные данные. Значения ниже взяты непосредственно из контракта шлюза.

Адрес API и авторизация

POST https://api.beatapi.io/v1/videos/tasks

Передавайте тело запроса в JSON с заголовком Content-Type: application/json. Idempotency-Key необязателен. Для каждого логического запроса используйте уникальное значение длиной не более 255 символов и повторно используйте его только для отправки точно такого же тела. В течение 24 часов повтор с тем же ключом и телом возвращает первый ответ с заголовком Idempotent-Replayed: true. Тот же ключ с другим телом возвращает 409 idempotency_conflict. Ответы, отличные от 2xx, не сохраняются, поэтому повтор после 400 или 402 выполняется заново.

Как выполняется запрос

Режимы ввода

Параметры запроса

Ограничения входных материалов

До создания задачи шлюз проверяет каждый входной материал. Если ограничение нарушено, возвращается 400 bad_request с указанием материала. Средства не списываются.

• Модель принимает только изображения, поэтому применима только строка изображений. Строки видео и аудио общие для семейства H3 и к этой модели не относятся.
• Изображения проверяются в порядке передачи. Сначала проверяются стороны, затем соотношение сторон. В сообщении указаны список и индекс с 0, как в ошибках полей: images[0] is 200x200 pixels; this model takes images 256 to 5760 pixels on each side.
• При создании задачи ссылка отклоняется только при ответе сервера HTTP 4xx или пустом файле, например images[1] could not be downloaded: the URL returned HTTP 404.. Остальные проблемы с материалом выявляются после отправки и завершают задачу ошибкой с возвратом средств.
• Файл находится на вашем устройстве? Загрузите его через POST /v1/files и передайте полученный data.url.

Параметры, которые модель не принимает

Эти параметры не игнорируются, а отклоняются до списания средств:

• aspect_ratio, reference_images, reference_videos, reference_audios, generate_audio, watermark, quality, sound и другие поля видеомоделей → field "aspect_ratio" is not supported by model minimax-h3-max (с именем переданного поля).
• Любое другое неизвестное поле → unknown field: <name>.

Для референсов используйте minimax-h3-fast (изображения, видео и аудио) либо minimax-h3-normal (изображения и одно видео).

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

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3-max",
  "prompt": "A slow cinematic push through a misty mountain village at dawn, smoke rising from the chimneys",
  "duration": 5,
  "resolution": "768P"
}'

Видео по тексту

Ролик длительностью 5 секунд в 768P.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3-max",
  "prompt": "A slow cinematic push through a misty mountain village at dawn, smoke rising from the chimneys",
  "duration": 5,
  "resolution": "768P"
}'

Первый кадр

Видео начинается с переданного изображения.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3-max",
  "prompt": "The performer turns toward the camera as neon light sweeps across the stage",
  "images": [
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 5,
  "resolution": "768P"
}'

Первый и последний кадры

Видео переходит от первого изображения ко второму, в 480P с фиксированным seed.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3-max",
  "prompt": "The camera moves smoothly from the bottle on the table to the singer on a neon stage in one continuous shot",
  "images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png",
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 6,
  "resolution": "480P",
  "seed": 42
}'

Ответы

Создание задачи (201)

Объект задачи. Поле output равно null, пока задача не завершится успешно. Поля с пометкой «во время выполнения» исчезают после завершения задачи.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "minimax-h3-max",
    "capability_version": 1,
    "media_type": "video",
    "model": "minimax-h3-max",
    "status": "queued",
    "stage": "queued",
    "created_at": 1791993600,
    "updated_at": 1791993600,
    "completed_at": null,
    "poll_after_seconds": 8,
    "output": null,
    "usage": {
      "credits_reserved": 0.4,
      "credits_settled": 0,
      "credits_refunded": 0,
      "credits_charged": 0.4,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Успешно завершённая задача

GET /v1/tasks/{task_id} возвращает HTTP 200 со status: "succeeded" и результатом в data.output.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "minimax-h3-max",
    "capability_version": 1,
    "media_type": "video",
    "model": "minimax-h3-max",
    "status": "succeeded",
    "stage": "succeeded",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": {
      "media": [
        {
          "type": "video",
          "url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4",
          "mime_type": "video/mp4"
        }
      ],
      "r2_url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4"
    },
    "usage": {
      "credits_reserved": 0.4,
      "credits_settled": 0.4,
      "credits_refunded": 0,
      "credits_charged": 0.4,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Поля результата

Задача, завершившаяся ошибкой

Если задача завершилась ошибкой, GET /v1/tasks/{task_id} всё равно возвращает HTTP 200: сведения об ошибке находятся в теле ответа. Зарезервированная сумма возвращается полностью, поэтому списания нет.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "minimax-h3-max",
    "capability_version": 1,
    "media_type": "video",
    "model": "minimax-h3-max",
    "status": "failed",
    "stage": "failed",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": null,
    "usage": {
      "credits_reserved": 0.4,
      "credits_settled": 0,
      "credits_refunded": 0.4,
      "credits_charged": 0,
      "billable_duration_seconds": 5
    },
    "retryable": true,
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": "processing_failed",
    "error_message": "The task failed during processing on our side. Retry; a failed task is refunded."
  }
}

Полный пример

Создайте задачу, дождитесь её завершения с интервалом опроса, указанным сервером, и выведите ссылки на результаты. Задайте BEATAPI_API_KEY в переменной окружения и установите requests.

import os
import time
import uuid
import requests
API = "https://api.beatapi.io"
HEADERS = {"Authorization": f"Bearer {os.environ['BEATAPI_API_KEY']}"}
def create_task(body: dict) -> dict:
    # One Idempotency-Key per logical request: a retry with the same key cannot create a second task.
    headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
    for attempt in range(3):
        response = requests.post(f"{API}/v1/videos/tasks", headers=headers, json=body, timeout=60)
        if response.status_code in (429, 503) and attempt < 2:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        break
    try:
        payload = response.json()
    except ValueError:  # an edge error page is not JSON
        response.raise_for_status()
        raise
    if not response.ok:
        error = payload["error"]
        raise RuntimeError(f"{response.status_code} {error['code']}: {error['message']} (request_id={error.get('request_id')})")
    return payload["data"]
def wait_for_task(task_id: str, timeout_seconds: int = 1800) -> dict:
    deadline = time.monotonic() + timeout_seconds
    while time.monotonic() < deadline:
        response = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
        if response.status_code == 429 or response.status_code >= 500:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        response.raise_for_status()
        task = response.json()["data"]
        if task["status"] in ("succeeded", "failed"):
            return task
        time.sleep(task.get("poll_after_seconds", 5))
    raise TimeoutError(f"task {task_id} is still running; keep polling later")
task = create_task({
  "model": "minimax-h3-max",
  "prompt": "A slow cinematic push through a misty mountain village at dawn, smoke rising from the chimneys",
  "duration": 5,
  "resolution": "768P"
})
print("created", task["id"])
task = wait_for_task(task["id"])
if task["status"] == "failed":
    raise SystemExit(f"{task['error_code']}: {task['error_message']}")
for item in task["output"]["media"]:
    print(item["url"])

Оплата

• Оплата посекундная: запрошенная duration умножается на тариф выбранного разрешения — примерно $0.05 за секунду в 480P и$0.08 в 768P. В таблице ниже указаны цены за 8 секунд.
• Тот же запрос к minimax-h3-max-turbo стоит вдвое дешевле.
• Число кадров и seed на цену не влияют.
• Цена резервируется при создании задачи. Оплаченная длительность указана в usage.billable_duration_seconds задачи.
• Если задача завершилась ошибкой, в том числе из-за модерации после отправки, средства возвращаются полностью.

Текущие базовые цены совпадают с указанными на странице цен. Если для аккаунта согласована скидка, стоимость будет ниже. Фактически списанная сумма всегда указана в data.usage задачи.

Частые ошибки

Краткий справочник HTTP-ошибок

Ошибки до создания задачи возвращаются с HTTP-статусом, отличным от 2xx, без списания средств. Обрабатывайте error.code или error.retryable; причина указана в message. Полный список и правила повторов приведены в разделе ошибок.

{
  "error": {
    "code": "bad_request",
    "message": "\"prompt\" is required",
    "retryable": false,
    "request_id": "req_5f0c2a9e4b7d4e31"
  }
}