Tạo video MiniMax H3 và Grok | Tài liệu 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.

Khả dụng

Khả dụng phụ thuộc vào khóa API API Hop của bạn. Chỉ gửi yêu cầu khi GET /v1/models trả về chính xác ID của mô hình cần dùng: minimax-h3 hoặc grok-imagine-video-1.5. Tài liệu không cấp quyền truy cập. Veo 3.1 Fast và Gemini Omni Flash không khả dụng trong hướng dẫn công khai này.

Tham số yêu cầu

Gửi JSON với Authorization: Bearer YOUR_APIHOP_API_KEY và Content-Type: application/json.

model	seconds	resolution	images	audios
`minimax-h3`	6-30	`768p` (mặc định), `480p`	0-8	0-3
`grok-imagine-video-1.5`	6-15	`720p`	0-7	Không hỗ trợ

Bắt buộc có model và chuỗi prompt không rỗng. Grok cho phép tối đa 1.200 ký tự. seconds nhận số nguyên hoặc chuỗi số nguyên, mặc định là 6. aspect_ratio mặc định là 16:9, cũng chấp nhận 9:16. images và audios là mảng URL HTTP(S); hình ảnh Grok cũng nhận URI data base64 PNG, JPEG hoặc WebP. H3 không đảm bảo đầu ra 480p; hãy dùng 768p. Bỏ stream hoặc đặt thành false. Các trường không được hỗ trợ và bí danh mâu thuẫn sẽ bị từ chối.

Ví dụ yêu cầu

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

Trạng thái và kết quả tác vụ

Yêu cầu được chấp nhận trả về HTTP 202, data.jobId dạng chuỗi thập phân và data.status: "PENDING". Giữ ID ở dạng chuỗi. Truy vấn GET /v1/jobs/{id} mỗi 5-10 giây bằng khóa của cùng tài khoản. PENDING, CONNECT và PROCESSING chưa phải trạng thái kết thúc. Khi COMPLETED, đọc URL video từ data.outputResult.result[].url; mỗi URL là một chuỗi. Dừng khi FAILED hoặc CANCELLED. Lưu video hoàn tất kịp thời. Nếu gửi bị hết thời gian hoặc xử lý kéo dài, hãy kiểm tra tác vụ hiện có và mức sử dụng tài khoản trước khi thử lại; một POST khác có thể tạo thêm tác vụ tính phí.

Tính phí

MiniMax H3 tính phí theo giây video được tạo; Grok Imagine Video 1.5 tính phí theo yêu cầu. Xem mức giá công bố tại Bảng giá. Không nhân giá mỗi yêu cầu của Grok với thời lượng video.