MiniMax H3 Image API: Tạo, Chỉnh sửa và Giá thực tế

So sánh giá cùng mô hình giữa các nền tảng: Cheap MiniMax H3 Image API · 2026-11-13

Khả năng của MiniMax H3 Image và giới hạn API được lưu trữ

Lý do mạnh nhất để đánh giá H3 Image là quy trình tạo và chỉnh sửa hợp nhất: mô tả một tài sản mới, cung cấp ảnh tham chiếu sản phẩm hoặc nhân vật, sau đó yêu cầu một thay đổi có mục tiêu. MiniMax cũng công bố trọng số cho việc triển khai cục bộ. Các tuyên bố về khả năng được công bố không đảm bảo việc bảo toàn chính xác logo, kiểu chữ hoặc danh tính trong mọi đầu ra.

Tính năng API được lưu trữ	Hợp đồng được ghi nhận
Tạo ảnh	POST /v1/images/generations
Chỉnh sửa	POST /v1/images/edits, 1–16 ảnh tham chiếu
Prompt	Tối đa 32.000 ký tự; nếu không bật enhancement, chỉ khoảng 4.096 token đầu tiên có hiệu lực
Kích thước đầu ra	655.360–20.000.000 pixel; tỷ lệ khung hình từ 1:3 đến 3:1
Số lượng đầu ra	n từ 1 đến 10
Định dạng	Mặc định là JPEG; hỗ trợ PNG hoặc WebP
Phản hồi	URL hoặc Base64 không streaming; hỗ trợ SSE gốc
Điều khiển không được hỗ trợ	Chỉnh sửa có mặt nạ, nền trong suốt và ảnh xem trước

Các tệp tham chiếu phải đáp ứng giới hạn đầu vào của MiniMax: JPG/JPEG, PNG, WebP, HEIC hoặc HEIF, mỗi chiều 128–8.192 pixel, tỷ lệ cạnh dài trên cạnh ngắn tối đa 4:1, và tổng phần thân yêu cầu tối đa 64 MiB. Base64 làm tăng kích thước yêu cầu. Hãy dùng URL ảnh có thể truy cập hoặc tải lên với kích thước phù hợp; khả năng chấp nhận 16 ảnh của mô hình không loại bỏ giới hạn kích thước phần thân.

“4K” là một thiết lập diện tích trong API này. area: "4K" nhắm tới khoảng 4096 × 4096 pixel, với các chiều được suy ra từ tỷ lệ khung hình. Ở 16:9, đầu ra được ghi nhận là 5472 × 3072, không phải 4096 × 2304. Để chỉ định chiều rõ ràng, gửi size: "WIDTHxHEIGHT" và bỏ qua area và aspect_ratio. Để định cỡ theo diện tích, dùng size: "auto", area và aspect_ratio. Kiểm tra data[].size và kích thước thực tế của ảnh đã tải xuống.

MiniMax H3 Image có giá bao nhiêu?

Đối với route Standard hiện tại trên APIMaster, cách tính theo giá thông thường là:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Dùng các trường usage văn bản và hình ảnh riêng biệt; không tính tất cả token đầu vào như văn bản rồi lại cộng thêm đầu vào hình ảnh. Việc tăng cường prompt đóng góp token văn bản bị tính phí, vì vậy chỉ riêng độ phân giải không quyết định tổng giá. Các hệ số theo từng tài khoản, nếu có, và việc làm tròn khi tính phí có thể ảnh hưởng đến khoản trừ cuối cùng.

Các tổng minh họa Standard chính thức của MiniMax cho thấy quy mô của hóa đơn. Đây là các ví dụ, không phải mức giá cố định của APIMaster hay mức trung bình đo được của chúng tôi:

Tác vụ	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, mức giá thông thường
Text-to-image	$0.02179	$0.02333	$0.06879
Chỉnh sửa với một ảnh tham chiếu 1K	$0.02654	$0.02658	$0.07312
Chỉnh sửa với ba ảnh tham chiếu 1K	$0.03563	$0.04177	$0.07914

Để tham khảo, 1.000 yêu cầu text-to-image ở ví dụ đầu tiên sẽ vào khoảng $21.79; đây là một phép tính ngân sách token minh họa, không phải gói trả trước. Prompt thực tế và việc tăng cường có thể thay đổi con số này. Nano Banana 2.1 có hợp đồng APIMaster khác, dựa trên độ phân giải, bắt đầu từ $15.12 cho 1.000 ảnh 1K trước bất kỳ điều kiện nào được báo giá riêng.

Chương trình khuyến mãi 4K giảm 50% chính thức có áp dụng trên APIMaster không?

Đừng mặc định rằng có. MiniMax quảng cáo giảm 50% tổng chi phí yêu cầu cho cả Standard và Highspeed đến hết ngày 17 tháng 11 năm 2026, 16:00 UTC (không bao gồm mốc này)—tức 00:00 ngày 18 tháng 11 theo giờ Bắc Kinh—khi ảnh được giao cuối cùng có ít nhất 16.600.000 pixel. Ví dụ text-to-image 4K vuông của họ thay đổi từ $0.06879 thành $0.03439 trong thời gian ưu đãi đó.

Đầu ra 4096 × 4096 đủ điều kiện theo diện tích; 4096 × 2304 thì không. Chỉ nhãn “4K” là không đủ. Route công khai hiện tại trên APIMaster sử dụng mức giá token thông thường, không áp dụng chương trình khuyến mãi tạm thời này. Hãy so sánh hợp đồng thanh toán/usage thực tế, không phải tiêu đề chiến dịch của MiniMax. Sau thời hạn, không nên dùng các ví dụ khuyến mãi làm giá hiện tại.

Ví dụ API MiniMax H3 Image: text-to-image

Tạo một tài khoản APIMaster, nạp số dư cho các yêu cầu ảnh trả phí, sau đó tạo khóa trong API keys. Đặt APIMASTER_API_KEY trong môi trường của bạn. Ví dụ này dùng đúng model ID phân biệt chữ hoa chữ thường của route Standard:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Đây là một ví dụ yêu cầu, không phải đánh giá chất lượng hình ảnh. Hãy tải xuống các URL đầu ra thành công ngay lập tức và lưu trữ tệp của bạn. Kiểm tra lỗi từng ảnh: với n > 1, HTTP 200 có thể bao gồm các ảnh bị lỗi. Timeout không chứng minh rằng yêu cầu đã bị từ chối. Việc tạo ảnh H3 không có tính idempotent, vì vậy thử lại tự động có thể tạo thêm một lần tạo ảnh bị tính phí. Nếu dùng OpenAI SDK, đặt timeout đủ dài và max_retries=0.

Chỉnh sửa ảnh với MiniMax H3 Image: ảnh tham chiếu và kiểm soát prompt

Để chỉnh sửa bằng JSON, gửi URL tham chiếu trong images[].image_url. Không sao chép trường image_urls của Nano Banana vào yêu cầu H3 này. Thay các URL ví dụ bằng tài sản có thể truy cập của riêng bạn:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Các kiểm tra nghiệm thu tích hợp ngày 11 tháng 11 hiện có của APIMaster đã bao gồm URL HTTP, data URI, tải lên multipart, chỉnh sửa nhiều tham chiếu, SSE và đầu ra được giải mã 1K/2K/4K. Một bài kiểm tra có kiểm soát với hai tham chiếu giữ lại được bốn hình dạng màu và hai nhãn ngắn. Đây là các kiểm tra giao diện và tính phí với tài sản đơn giản, không phải một đánh giá nhiếp ảnh hay kiểu chữ toàn diện; chúng không thiết lập tính vượt trội so với một mô hình khác.

Việc tạo ảnh mặc định dùng tăng cường prompt; bạn có thể tắt nó bằng disable_prompt_enhanced: true trong khi cung cấp kích thước cố định hoặc tỷ lệ khung hình cố định. Việc chỉnh sửa luôn dùng tăng cường. Kiểm tra revised_prompt khi chẩn đoán các thay đổi bất ngờ. Đối với công việc sản phẩm, hãy chỉ rõ những gì phải giữ cố định, xác định vai trò của từng tham chiếu và xác minh nhãn được hiển thị trước khi công bố.

Standard so với Highspeed, và trọng số mở so với API được lưu trữ

Highspeed dùng cùng các tham số API được ghi nhận, nhưng mức giá đầu vào hình ảnh và đầu ra hình ảnh chính thức của nó gấp đôi Standard; đầu vào văn bản vẫn là $2.30/M. APIMaster hiện chỉ liệt kê Standard. Các tuyên bố về tốc độ khi ra mắt của MiniMax phụ thuộc vào biến thể mô hình, kích thước và triển khai, và không phải là đảm bảo độ trễ đo được của APIMaster.

Kho lưu trữ Hugging Face chính thức cung cấp trọng số và các tích hợp bao gồm Diffusers, SGLang, vLLM-Omni và ComfyUI. Checkpoint BF16 của nó khoảng 68,65 GB, với một text encoder riêng khoảng 66,7 GB. Kích thước tải xuống không phải là ước tính đầy đủ về bộ nhớ GPU. Trọng số cục bộ dùng giấy phép cộng đồng MiniMax H3 Image, vì vậy hãy xem xét giấy phép đó trước khi triển khai; “trọng số mở” không có nghĩa là sử dụng không hạn chế theo MIT hay Apache.

Dùng quyền truy cập được lưu trữ để đánh giá prompt mà không cần xây dựng hạ tầng suy luận. Cân nhắc triển khai cục bộ khi việc kiểm soát suy luận biện minh cho công việc về GPU, bảo trì và cấp phép. Giới hạn của pipeline cục bộ và giới hạn của API được lưu trữ là những hợp đồng khác nhau.

FAQ

MiniMax H3 Image có giống với video MiniMax H3 không?

Không. H3 Image tạo và chỉnh sửa ảnh tĩnh bằng MiniMax-H3-Image. Dòng video H3 có các model ID, endpoint và cách tính phí khác. Xem hướng dẫn video MiniMax H3 riêng.

MiniMax H3 Image có khả dụng trên APIMaster không?

Có. Kiểm tra ngày 13 tháng 11 cho thấy một route Standard công khai được bật, tính phí $2.30/M đầu vào văn bản, $1.50/M đầu vào hình ảnh và $3.80/M đầu ra hình ảnh. Highspeed không có route công khai. Kiểm tra thẻ mô hình trực tiếp trước khi gửi yêu cầu.

H3 Image có phải là API cố định $0.02 mỗi ảnh không?

Không. Các ví dụ chính thức theo mỗi ảnh là tổng minh họa. Việc dùng token thực tế, tăng cường prompt, đầu vào tham chiếu và kích thước đầu ra quyết định hóa đơn. Route APIMaster hiện tại dùng công thức token thông thường.

H3 Image có thể chỉnh sửa với 16 tham chiếu hoặc mặt nạ không?

Mô hình ghi nhận hỗ trợ tối đa 16 ảnh tham chiếu trong giới hạn định dạng và kích thước yêu cầu. Chỉnh sửa có mặt nạ và nền trong suốt không được hỗ trợ. Hướng dẫn dựa trên tham chiếu không đảm bảo bảo toàn chính xác đến từng pixel.

Cái nào rẻ hơn: H3 Image hay Nano Banana 2.1?

Đối với tác vụ text-to-image 1K được minh họa, ví dụ chính thức thông thường của H3 là $0.02179, so với Nano Banana 2.1 trên APIMaster từ $0.01512 mỗi ảnh 1K. Đây là so sánh giữa một tổng token ví dụ và một báo giá theo độ phân giải; hãy đo chi phí đầu ra được chấp nhận thực tế cho các prompt của bạn. Xem so sánh chuyên biệt.

Nguồn và các bước tiếp theo

Các nguồn được kiểm tra ngày 13 tháng 11 năm 2026: bài phát hành MiniMax, hướng dẫn API được lưu trữ, giá và khuyến mãi chính thức, trọng số và giấy phép mô hình, giá hình ảnh của Google, và các thẻ thị trường trực tiếp của APIMaster. Các mô tả về khả năng đến từ nhà cung cấp tương ứng; các kiểm tra giá và các quan sát tích hợp APIMaster có ghi ngày được nêu riêng.

Mở thẻ H3 Image, đăng ký, tạo một API key, và gửi MiniMax-H3-Image tới https://apimaster.ai/v1. Để có một lựa chọn thay thế được giảm giá với hợp đồng tính phí khác, so sánh các route Nano Banana 2.1, hiện thấp hơn tới 55% so với giá tham chiếu đầu ra hình ảnh của Google.