# MiniMax H3 Max Text to Video API

> Generate 1080p video from text with the MiniMax H3 Max API on Muapi. Cinematic motion, prompt expansion, pay per generation.

## Tổng quan

- **Endpoint**: `POST https://api.muapi.ai/api/v1/minimax-h3-max-text-to-video`
- **Mã mẫu**: `minimax-h3-max-text-to-video`
- **Danh mục**: Chuyển văn bản thành video
- **Biến thể**: MiniMax H3 Max Text to Video
- **Nhóm**: minimax-h3-max
- **Chi phí**: 0.26 tín dụng cho mỗi cuộc gọi (một số mô hình tính toán chi phí linh hoạt dựa trên thông số)

## Sử dụng API

MuApi sử dụng mẫu **gửi rồi thăm dò ý kiến**: gửi công việc, nhận `request_id`, sau đó thăm dò điểm cuối dự đoán cho đến khi `trạng thái` là `hoàn thành`. Tùy chọn chuyển `?webhook=YOUR_URL` trong lệnh gọi gửi để nhận lệnh gọi lại POST khi công việc kết thúc (bỏ qua bỏ phiếu).

**Xác thực**: gửi khóa MuApi của bạn trong tiêu đề `x-api-key`. Nhận một cái tại https://muapi.ai/access-keys.

### 1. Gửi tác vụ

```http
POST https://api.muapi.ai/api/v1/minimax-h3-max-text-to-video
Content-Type: application/json
x-api-key: YOUR_API_KEY
```

**Tối thiểu (chỉ bắt buộc):**

```json
{
  "prompt": "<prompt>"
}
```

**Ví dụ đầy đủ (tất cả các thông số):**

```json
{
  "prompt": "<prompt>",
  "aspect_ratio": "16:9",
  "resolution": "768p",
  "duration": 5,
  "prompt_expansion_mode": "balanced"
}
```

**Phản hồi:**

```json
{
  "request_id": "abc123",
  "status": "processing"
}
```

### 2. Kiểm tra kết quả

```http
GET https://api.muapi.ai/api/v1/predictions/{request_id}/result
x-api-key: YOUR_API_KEY
```

Các giá trị `trạng thái` có thể có: `được xếp hàng`, `đang chờ`, `đang xử lý`, `đã hoàn thành`, `không thành công`, `đã hủy`. Thăm dò ý kiến ​​cứ sau 2-5 giây cho đến khi kết thúc. Khi `hoàn thành`, các URL kết quả nằm trong mảng `đầu ra`.

**Phản hồi ví dụ khi `hoàn thành`:**

```json
{
  "id": "abc123",
  "status": "completed",
  "outputs": [
    "https://cdn.muapi.ai/.../output.png"
  ],
  "urls": {
    "get": "https://api.muapi.ai/api/v1/predictions/abc123/result"
  },
  "created_at": "2026-05-08T12:34:56Z",
  "has_nsfw_contents": []
}
```

### cURL

```bash
1. Gửi tác vụ
REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/minimax-h3-max-text-to-video \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"<prompt>"}' | jq -r .request_id)

2. Thăm dò cho đến khi hoàn thành
while :; do
  RESP=$(curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY")
  STATUS=$(echo "$RESP" | jq -r .status)
  [ "$STATUS" = "completed" ] && echo "$RESP" | jq .outputs && break
  [ "$STATUS" = "failed" ] && echo "$RESP" && exit 1
  sleep 3
done
```

### Python

```python
import os, time, requests

API = "https://api.muapi.ai/api/v1"
headers = {"x-api-key": os.environ["MUAPI_API_KEY"]}

r = requests.post(f"{API}/minimax-h3-max-text-to-video", headers=headers, json={"prompt":"<prompt>"})
request_id = r.json()["request_id"]

while True:
    res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json()
    if res["status"] == "completed":
        print(res["outputs"]); break
    if res["status"] == "failed":
        raise RuntimeError(res.get("error")); 
    time.sleep(3)
```

## Lược đồ đầu vào

API chấp nhận các tham số đầu vào sau:

- **`prompt`** (`string`, _required_):
  、、。

- **`aspect_ratio`** (`string`, _optional_):
  Không có mô tả.
  - Mặc định: `"16:9"`
  - Tùy chọn: `"21:9"`, `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`

- **`resolution`** (`string`, _optional_):
  Output resolution. 1080p applies latent refinement from a 768p source.
  - Mặc định: `"768p"`
  - Tùy chọn: `"480p"`, `"768p"`, `"1080p"`

- **`duration`** (`integer`, _optional_):
  （）。
  - Mặc định: `5`
  - Tùy chọn: `"5"`, `"6"`, `"7"`, `"8"`, `"9"`, `"10"`, `"11"`, `"12"`, `"13"`, `"14"`, `"15"`

- **`prompt_expansion_mode`** (`string`, _optional_):
  Prompt rewriting effort. 'quality' can add up to ~30s of processing.
  - Mặc định: `"balanced"`
  - Tùy chọn: `"disabled"`, `"balanced"`, `"quality"`

## Lược đồ đầu ra

Điểm cuối bỏ phiếu trả về các trường sau:

- **`id`** (`string`): ID yêu cầu.
- **`status`** (`string`): Một trong số `xếp hàng`, `đang chờ xử lý`, `đang xử lý`, `đã hoàn thành`, `không thành công`, `đã hủy`.
- **`outputs`** (`array`): URL tới hình ảnh/video/âm thanh được tạo. Để trống cho đến khi `trạng thái` được` hoàn thành`.
- **`urls.get`** (`string`): Tự liên kết để tìm nạp lại dự đoán này.
- **`error`** (`string` | `null`): Thông báo lỗi nếu `trạng thái` là `không thành công`.
- **`created_at`** (`string`): Dấu thời gian ISO-8601 về thời điểm yêu cầu được tạo.
- **`has_nsfw_contents`** (`array of boolean`): Cờ phát hiện NSFW trên mỗi đầu ra.

## Webhooks (tùy chọn)

Nối `?webhook=https://your-server/path` vào URL gửi. Khi công việc đạt đến trạng thái cuối, MuApi sẽ ĐĂNG hình dạng giống như phản hồi bỏ phiếu cho URL của bạn - không cần bỏ phiếu.

## Tích hợp đại lý

MuApi gửi máy chủ MCP và CLI để các đại lý (Mã Claude, Con trỏ, tùy chỉnh) có thể gọi điểm cuối này mà không cần viết mã HTTP:

```bash
# Cài đặt CLI
npm install -g muapi-cli

# Xác thực một lần
muapi auth login

# Expose all MuApi models as MCP tools to your agent
muapi mcp serve
```

Máy chủ MCP hiển thị các công cụ bao gồm việc gửi + thăm dò ý kiến cho mọi mô hình, bao gồm cả `minimax-h3-max-text-to-video`. Xem `muapi --help` để biết các phím tắt dành riêng cho danh mục (`tạo hình ảnh muaapi`, `muapi video từ hình ảnh`, v.v.).

## Mô hình liên quan
- [MiniMax H3 Max Image to Video](https://muapi.ai/vi/playground/minimax-h3-max-image-to-video)
- [MiniMax H3 Max Turbo Text to Video](https://muapi.ai/vi/playground/minimax-h3-max-turbo-text-to-video)
- [MiniMax H3 Max Turbo Image to Video](https://muapi.ai/vi/playground/minimax-h3-max-turbo-image-to-video)
- [MiniMax H3 Max Text to Video](https://muapi.ai/vi/playground/minimax-h3-max-text-to-video)
- [MiniMax H3 Max Reference to Video](https://muapi.ai/vi/playground/minimax-h3-max-reference-to-video)

## Tài nguyên
- [Trang sân chơi](https://muapi.ai/vi/playground/minimax-h3-max-text-to-video)
- [Tham khảo API](https://muapi.ai/vi/playground/minimax-h3-max-text-to-video/api)
- [llms.txt toàn cầu](https://muapi.ai/vi/llms.txt)