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를 문자열로 유지하세요. 같은 계정의 키로 GET /v1/jobs/{id}를 5~10초마다 조회하세요. PENDING, CONNECT, PROCESSING은 종료 상태가 아닙니다. COMPLETED이면 data.outputResult.result[].url에서 동영상 URL을 읽으세요. 각 URL은 문자열입니다. FAILED 또는 CANCELLED이면 조회를 중단하세요. 완성된 동영상은 신속히 저장하세요. 요청 시간 초과나 장시간 처리 시 재시도 전에 기존 작업과 계정 사용량을 확인하세요. 새 POST는 별도의 유료 작업을 만들 수 있습니다.

과금

MiniMax H3는 생성 동영상의 초 단위로, Grok Imagine Video 1.5는 요청당 과금됩니다. 공개 요금은 가격 페이지를 확인하세요. Grok의 요청당 가격에 동영상 길이를 곱하지 마세요.