إنشاء الفيديو باستخدام 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 معرّف النموذج المطلوب بالضبط: 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 ما يصل إلى 1,200 محرف. يقبل 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". احتفظ بالمعرّف كسلسلة. استعلم عن 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 في مدة الفيديو.