MiniMax H3 und Grok Videogenerierung | API-Dokumentation

# 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.

Verfügbarkeit

Die Verfügbarkeit hängt von Ihrem API Hop API Key ab. Senden Sie eine Anfrage nur, wenn GET /v1/models die genaue ID des gewünschten Modells zurückgibt: minimax-h3 oder grok-imagine-video-1.5. Die Dokumentation gewährt keinen Zugriff. Veo 3.1 Fast und Gemini Omni Flash sind über diese öffentliche Anleitung nicht verfügbar.

Anfrageparameter

Senden Sie JSON mit Authorization: Bearer YOUR_APIHOP_API_KEY und Content-Type: application/json.

model	seconds	resolution	images	audios
`minimax-h3`	6-30	`768p` (Standard), `480p`	0-8	0-3
`grok-imagine-video-1.5`	6-15	`720p`	0-7	Nicht unterstützt

model und ein nicht leerer String prompt sind erforderlich. Grok erlaubt höchstens 1.200 Zeichen im Prompt. seconds akzeptiert eine Ganzzahl oder einen Ganzzahl-String; Standard ist 6. aspect_ratio ist standardmäßig 16:9; auch 9:16 ist zulässig. images und audios sind Arrays von HTTP(S)-URLs; Grok akzeptiert für Bilder auch PNG-, JPEG- oder WebP-base64-Data-URIs. H3 garantiert keine 480p-Ausgabe; verwenden Sie 768p. Lassen Sie stream weg oder setzen Sie es auf false. Nicht unterstützte Felder und widersprüchliche Aliase werden abgelehnt.

Anfragebeispiele

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"
}

Auftragsstatus und Ergebnisse

Eine akzeptierte Anfrage liefert HTTP 202, data.jobId als Dezimal-String und data.status: "PENDING". Behalten Sie die ID als String. Fragen Sie GET /v1/jobs/{id} alle 5-10 Sekunden mit einem Key desselben Kontos ab. PENDING, CONNECT und PROCESSING sind nicht endgültig. Bei COMPLETED stehen die Video-URLs unter data.outputResult.result[].url, jeweils als String. Beenden Sie die Abfrage bei FAILED oder CANCELLED. Speichern Sie fertige Videos zeitnah. Prüfen Sie bei einem Timeout oder anhaltender Verarbeitung den bestehenden Auftrag und die Kontonutzung vor einem erneuten Versuch; ein weiterer POST kann einen weiteren kostenpflichtigen Auftrag erzeugen.

Abrechnung

MiniMax H3 wird pro Sekunde des generierten Videos abgerechnet, Grok Imagine Video 1.5 pro Anfrage. Veröffentlichte Preise finden Sie unter Preise. Multiplizieren Sie Groks Preis pro Anfrage nicht mit der Videodauer.