Генерация видео MiniMax H3 и Grok | Документация API

# MiniMax H3 and Grok Video Generation

MiniMax H3 and Grok Imagine Video 1.5 asynchronous requests, limits, billing units, and job polling.

POST https://api.apihop.ai/v1/video-generations

## Availability

Availability depends on your API Hop API Key. Submit a request only when [GET https://api.apihop.ai/v1/models](https://apihop.ai/en/docs/api-reference/models) returns its exact model ID: `minimax-h3` or `grok-imagine-video-1.5`. Documentation does not enable access. Veo 3.1 Fast and Gemini Omni Flash are not available through this public guide.

## Request Parameters

Send JSON with `Authorization: Bearer YOUR_APIHOP_API_KEY` and `Content-Type: application/json`.

| model | seconds | resolution | images | audios |
| --- | --- | --- | --- | --- |
| `minimax-h3` | 6-30 | `768p` (default), `480p` | 0-8 | 0-3 |
| `grok-imagine-video-1.5` | 6-15 | `720p` | 0-7 | Unsupported |

`model` and a non-empty string `prompt` are required. Grok prompts may contain at most 1,200 characters. `seconds` accepts an integer or integer string and defaults to 6. `aspect_ratio` defaults to `16:9`; `9:16` is also accepted. `images` and `audios` are arrays of HTTP(S) URLs; Grok images also accept PNG, JPEG, or WebP base64 data URIs. H3 does not guarantee 480p output; use 768p. Omit `stream` or set it to `false`. Unsupported fields and conflicting aliases are rejected.

## Request Examples

```bash
curl --request POST \
  --url https://api.apihop.ai/v1/video-generations \
  --header 'Authorization: Bearer YOUR_APIHOP_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"model":"minimax-h3","prompt":"A slow pan across a mountain lake","seconds":"6","resolution":"768p","aspect_ratio":"16:9"}'
```

```json
{
  "model": "grok-imagine-video-1.5",
  "prompt": "A slow pan across a mountain lake",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
```

## Job Status and Results

An accepted request returns HTTP `202`, `data.jobId` as a decimal string, and `data.status: "PENDING"`. Preserve the ID as a string. Poll [GET https://api.apihop.ai/v1/jobs/{id}](https://apihop.ai/en/docs/api-reference/jobs) with a key from the same account every 5-10 seconds. `PENDING`, `CONNECT`, and `PROCESSING` are non-terminal. On `COMPLETED`, read video URLs from `data.outputResult.result[].url`; each URL is a string. Stop polling on `FAILED` or `CANCELLED`. Save completed videos promptly. If submission times out or a job remains processing, check the existing job and account usage before retrying; another POST can create another charged task.

## Billing

MiniMax H3 is billed per second of generated video; Grok Imagine Video 1.5 is billed per request. See [Pricing](https://apihop.ai/en/docs/pricing) for published rates. Do not multiply Grok's per-request price by video duration.

Доступность

Доступность зависит от вашего API-ключа API Hop. Отправляйте запрос только тогда, когда GET /v1/models возвращает точный ID нужной модели: minimax-h3 или grok-imagine-video-1.5. Документация не предоставляет доступ. Veo 3.1 Fast и Gemini Omni Flash недоступны в рамках этого публичного руководства.

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

Отправляйте JSON с Authorization: Bearer YOUR_APIHOP_API_KEY и Content-Type: application/json.

model	seconds	resolution	images	audios
`minimax-h3`	6-30	`768p` (по умолчанию), `480p`	0-8	0-3
`grok-imagine-video-1.5`	6-15	`720p`	0-7	Не поддерживается

Обязательны model и непустая строка prompt. Для Grok допустимо не более 1200 символов. seconds принимает целое число или его строковую запись; по умолчанию 6. aspect_ratio по умолчанию равен 16:9; также доступен 9:16. images и audios — массивы HTTP(S)-адресов; для изображений Grok также принимает PNG, JPEG или WebP в виде base64 data URI. H3 не гарантирует вывод 480p; используйте 768p. Не передавайте stream либо задайте false. Неподдерживаемые поля и противоречащие друг другу псевдонимы отклоняются.

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

bash

curl --request POST \
  --url https://api.apihop.ai/v1/video-generations \
  --header 'Authorization: Bearer YOUR_APIHOP_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"model":"minimax-h3","prompt":"A slow pan across a mountain lake","seconds":"6","resolution":"768p","aspect_ratio":"16:9"}'

json

{
  "model": "grok-imagine-video-1.5",
  "prompt": "A slow pan across a mountain lake",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Статус задач и результаты

Принятый запрос возвращает HTTP 202, data.jobId в виде десятичной строки и data.status: "PENDING". Сохраняйте ID как строку. Проверяйте GET /v1/jobs/{id} каждые 5–10 секунд ключом того же аккаунта. PENDING, CONNECT и PROCESSING не являются конечными статусами. При COMPLETED читайте ссылки на видео из data.outputResult.result[].url; каждая ссылка — строка. Прекратите опрос при FAILED или CANCELLED. Сохраняйте готовые видео своевременно. При тайм-ауте или длительной обработке перед повтором проверьте существующую задачу и расход аккаунта; новый POST может создать ещё одну платную задачу.

Оплата

MiniMax H3 оплачивается за секунду созданного видео, Grok Imagine Video 1.5 — за запрос. Опубликованные ставки см. в ценах. Не умножайте стоимость запроса Grok на длительность видео.