การสร้างวิดีโอ 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 Key ของ API Hop ของคุณ ส่งคำขอเฉพาะเมื่อ GET /v1/models ส่งคืน ID ของโมเดลที่ต้องการตรงกัน คือ 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 เป็นอาร์เรย์ URL แบบ HTTP(S) ส่วนรูปภาพของ Grok ยังรับ data URI แบบ base64 ของ PNG, JPEG หรือ WebP ได้ 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 เป็นสตริง ใช้คีย์ของบัญชีเดียวกันตรวจสอบ GET /v1/jobs/{id} ทุก 5-10 วินาที PENDING, CONNECT และ PROCESSING ยังไม่ใช่สถานะสิ้นสุด เมื่อเป็น COMPLETED ให้อ่าน URL วิดีโอจาก data.outputResult.result[].url โดยแต่ละ URL เป็นสตริง หยุดตรวจสอบเมื่อเป็น FAILED หรือ CANCELLED บันทึกวิดีโอที่เสร็จแล้วโดยเร็ว หากส่งคำขอหมดเวลาหรืองานประมวลผลนาน ให้ตรวจสอบงานเดิมและการใช้งานบัญชีก่อนลองใหม่ เพราะ POST อีกครั้งอาจสร้างงานที่คิดค่าบริการเพิ่ม

การคิดค่าบริการ

MiniMax H3 คิดค่าบริการต่อวินาทีของวิดีโอที่สร้าง ส่วน Grok Imagine Video 1.5 คิดต่อคำขอ ดูอัตราที่เผยแพร่ในหน้า ราคา อย่านำราคาต่อคำขอของ Grok ไปคูณด้วยความยาววิดีโอ