MiniMax H3 ve Grok video oluşturma | API Belgeleri

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

Kullanılabilirlik

Kullanılabilirlik, API Hop API anahtarınıza bağlıdır. Yalnızca GET /v1/models istenen modelin tam kimliğini döndürdüğünde istek gönderin: minimax-h3 veya grok-imagine-video-1.5. Dokümantasyon erişim sağlamaz. Veo 3.1 Fast ve Gemini Omni Flash bu genel kılavuz üzerinden kullanılamaz.

İstek parametreleri

JSON gönderirken Authorization: Bearer YOUR_APIHOP_API_KEY ve Content-Type: application/json kullanın.

model	seconds	resolution	images	audios
`minimax-h3`	6-30	`768p` (varsayılan), `480p`	0-8	0-3
`grok-imagine-video-1.5`	6-15	`720p`	0-7	Desteklenmiyor

model ve boş olmayan prompt metni zorunludur. Grok en fazla 1.200 karakter kabul eder. seconds tam sayı veya tam sayı metni kabul eder; varsayılan 6’dır. aspect_ratio varsayılan olarak 16:9 kullanır; 9:16 da geçerlidir. images ve audios, HTTP(S) URL dizileridir; Grok görüntüleri PNG, JPEG veya WebP base64 data URI biçiminde de kabul eder. H3, 480p çıktıyı garanti etmez; 768p kullanın. stream alanını atlayın veya false yapın. Desteklenmeyen alanlar ve çelişen takma adlar reddedilir.

İstek örnekleri

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

Görev durumu ve sonuçlar

Kabul edilen istek HTTP 202, ondalık metin olarak data.jobId ve data.status: "PENDING" döndürür. Kimliği metin olarak saklayın. Aynı hesaba ait anahtarla GET /v1/jobs/{id} çağrısını 5-10 saniyede bir sorgulayın. PENDING, CONNECT ve PROCESSING son durum değildir. COMPLETED olduğunda video URL’lerini data.outputResult.result[].url içinden okuyun; her URL bir metindir. FAILED veya CANCELLED durumunda durun. Tamamlanan videoları gecikmeden kaydedin. Zaman aşımı veya uzun süren işlemde yeniden denemeden önce mevcut görevi ve hesap kullanımını kontrol edin; yeni POST ayrıca ücretlendirilen bir görev oluşturabilir.

Ücretlendirme

MiniMax H3 oluşturulan videonun saniyesi başına, Grok Imagine Video 1.5 istek başına ücretlendirilir. Yayımlanan ücretler için Fiyatlar sayfasına bakın. Grok’un istek başına ücretini video süresiyle çarpmayın.