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 Hop API कुंजी पर निर्भर करती है। अनुरोध केवल तभी भेजें जब GET /v1/models उस मॉडल का सटीक ID लौटाए: minimax-h3 या grok-imagine-video-1.5। दस्तावेज़ उपलब्ध होने से पहुँच नहीं मिलती। Veo 3.1 Fast और Gemini Omni Flash इस सार्वजनिक गाइड के अंतर्गत उपलब्ध नहीं हैं।

अनुरोध पैरामीटर

Authorization: Bearer YOUR_APIHOP_API_KEY और Content-Type: application/json के साथ 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 प्रॉम्प्ट में अधिकतम 1,200 अक्षर हो सकते हैं। seconds पूर्णांक या पूर्णांक स्ट्रिंग स्वीकार करता है और डिफ़ॉल्ट 6 है। aspect_ratio का डिफ़ॉल्ट 16:9 है; 9:16 भी स्वीकार्य है। images और audios HTTP(S) URL की सरणियाँ हैं; 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 को स्ट्रिंग ही रखें। उसी खाते की कुंजी से हर 5-10 सेकंड में GET /v1/jobs/{id} जाँचें। PENDING, CONNECT और PROCESSING अंतिम स्थितियाँ नहीं हैं। COMPLETED होने पर data.outputResult.result[].url से वीडियो URL पढ़ें; हर URL एक स्ट्रिंग है। FAILED या CANCELLED होने पर जाँच बंद करें। तैयार वीडियो तुरंत सहेजें। अनुरोध टाइमआउट होने या लंबे समय तक प्रक्रिया चलने पर दोबारा कोशिश से पहले मौजूदा कार्य और खाते का उपयोग जाँचें; दूसरा POST एक और शुल्क वाला कार्य बना सकता है।

बिलिंग

MiniMax H3 का शुल्क बने वीडियो के प्रति सेकंड और Grok Imagine Video 1.5 का प्रति अनुरोध लिया जाता है। प्रकाशित दरें मूल्य पृष्ठ पर देखें। Grok के प्रति-अनुरोध मूल्य को वीडियो की अवधि से गुणा न करें।