# Minimax Hailuo 2.3 Pro Text to Video

> Tích hợp mô hình AI minimax-hailuo-2.3-pro-t2v qua API hiệu suất cao và giá cả linh hoạt.

## Tổng quan

- **Điểm cuối**: `POST https://api.muapi.ai/api/v1/minimax-hailuo-2.3-pro-t2v`
- **Mã mẫu**: `minimax-hailuo-2.3-pro-t2v`
- **Danh mục**: Chuyển văn bản thành video
- **Biến thể**: Pro T2V
- **Nhóm**: minimax-2.3
- **Chi phí**: 0.63 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-hailuo-2.3-pro-t2v
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>",
  "resolution": "1080p"
}
```

**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-hailuo-2.3-pro-t2v \
  -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-hailuo-2.3-pro-t2v", 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_):
  。

- **`resolution`** (`string`, _optional_):
  。
  - Mặc định: `"1080p"`
  - Tùy chọn: `"1080p"`

## 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

# Hiển thị tất cả các mô hình MuApi dưới dạng công cụ MCP cho đại lý của bạn
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-hailuo-2.3-pro-t2v`. 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
- [Pro T2V](https://muapi.ai/vi/playground/minimax-hailuo-2.3-pro-t2v)
- [Standard I2V](https://muapi.ai/vi/playground/minimax-hailuo-2.3-standard-i2v)
- [Pro I2V](https://muapi.ai/vi/playground/minimax-hailuo-2.3-pro-i2v)
- [Fast I2V](https://muapi.ai/vi/playground/minimax-hailuo-2.3-fast)
- [Voice Clone](https://muapi.ai/vi/playground/minimax-voice-clone)
- [Standard T2V](https://muapi.ai/vi/playground/minimax-hailuo-2.3-standard-t2v)

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