Pembuatan video MiniMax H3 dan Grok | Dokumentasi 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.

Ketersediaan

Ketersediaan bergantung pada kunci API API Hop Anda. Kirim permintaan hanya jika GET /v1/models mengembalikan ID model yang diminta secara tepat: minimax-h3 atau grok-imagine-video-1.5. Dokumentasi tidak memberikan akses. Veo 3.1 Fast dan Gemini Omni Flash tidak tersedia melalui panduan publik ini.

Parameter permintaan

Kirim JSON dengan Authorization: Bearer YOUR_APIHOP_API_KEY dan 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	Tidak didukung

model dan string prompt yang tidak kosong wajib diisi. Prompt Grok maksimal 1.200 karakter. seconds menerima bilangan bulat atau string bilangan bulat, dengan nilai default 6. aspect_ratio secara default adalah 16:9; 9:16 juga diterima. images dan audios adalah array URL HTTP(S); gambar Grok juga menerima URI data base64 PNG, JPEG, atau WebP. H3 tidak menjamin keluaran 480p; gunakan 768p. Hilangkan stream atau atur ke false. Kolom yang tidak didukung dan alias yang bertentangan akan ditolak.

Contoh permintaan

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

Status dan hasil tugas

Permintaan yang diterima mengembalikan HTTP 202, data.jobId sebagai string desimal, dan data.status: "PENDING". Simpan ID sebagai string. Periksa GET /v1/jobs/{id} setiap 5-10 detik dengan kunci dari akun yang sama. PENDING, CONNECT, dan PROCESSING bukan status akhir. Saat COMPLETED, baca URL video dari data.outputResult.result[].url; setiap URL berupa string. Hentikan pemeriksaan saat FAILED atau CANCELLED. Segera simpan video yang selesai. Jika pengiriman kehabisan waktu atau tugas lama diproses, periksa tugas yang ada dan penggunaan akun sebelum mencoba lagi; POST lain dapat membuat tugas berbayar lain.

Penagihan

MiniMax H3 ditagih per detik video yang dihasilkan; Grok Imagine Video 1.5 per permintaan. Lihat tarif yang dipublikasikan di Harga. Jangan mengalikan harga per permintaan Grok dengan durasi video.