MiniMax H3-Image là mô hình hình ảnh open-weight của MiniMax, ra mắt ngày 10 tháng 11 năm 2026, có khả năng tạo và chỉnh sửa ảnh ở độ phân giải khoảng 16 megapixel (4096 x 4096) mà không cần upscaler. MiniMax cho biết một ảnh 4K chỉ mất khoảng 10 giây. Bạn có thể gọi mô hình này qua MiniMax API, dùng trong Hailuo AI và MiniMax Code, hoặc tải weights từ Hugging Face.
Bài hướng dẫn này giải thích MiniMax H3-Image là gì, MiniMax thực sự tuyên bố những gì, "open-weight" nghĩa là gì theo giấy phép của mô hình, giá cả trong tuần khuyến mãi ra mắt, và cách kiểm thử API từ coding agent của bạn.
MiniMax H3-Image là gì?
MiniMax H3-Image là mô hình text-to-image và chỉnh sửa ảnh thuộc dòng MiniMax H3. Một checkpoint duy nhất đảm nhận cả hai nhiệm vụ: tạo ảnh từ prompt và chỉnh sửa tối đa 16 ảnh tham chiếu. Nó xuất ra khoảng 16 megapixel với mọi tỷ lệ khung hình, từ 4096 x 4096 (1:1) đến 6272 x 2688 (21:9), và weights được phát hành theo giấy phép cộng đồng.
Trong bài đăng ra mắt trên X của MiniMax, thông điệp rất ngắn gọn: "Tạo ảnh 4K trong 10 giây," 16 triệu pixel, chân thực, làm theo prompt và chỉnh sửa chính xác, tối đa 16 ảnh tham chiếu, và weights mở.
H3-Image tách biệt với mô hình lập trình của MiniMax (được trình bày trong bài giải thích về MiniMax M3) và có các API endpoint riêng.
Những gì MiniMax tuyên bố về H3-Image
Dưới đây là những gì MiniMax công bố trên model card trên Hugging Face và trong thông báo. Hãy xem các con số về tốc độ và chất lượng là tuyên bố của MiniMax; tại thời điểm viết bài, chưa có bên ngoài nào công bố kết quả đo lường độc lập.
| Tuyên bố | MiniMax nói gì | Nguồn |
|---|---|---|
| Độ phân giải | Khoảng 16 MP, 4096 x 4096 ở 1:1, tối đa 6272 x 2688 ở 21:9, không cần upscaler | Model card |
| Tốc độ | Một ảnh 4K trong khoảng 10 giây | Bài đăng ra mắt |
| Sampling | Chưng cất xuống 6 bước sampling, không dùng classifier-free guidance | Model card |
| Ảnh tham chiếu | Tối đa 16 ảnh tham chiếu mỗi lần chỉnh sửa | Model card, hướng dẫn API |
| Làm theo chỉ dẫn | "Khả năng làm theo chỉ dẫn mạnh nhất trong các mô hình open-source" | Model card |
| Phạm vi hoạt động | Khoảng 4 MP đến 20 MP, kết quả tốt nhất quanh 16 MP | Model card |
Tuyên bố về tốc độ dựa trên 6 bước chưng cất và không dùng classifier-free guidance — thứ thường làm tăng gấp đôi khối lượng công việc mỗi bước. MiniMax không nêu phần cứng đằng sau con số 10 giây, nên đừng hiểu đó là lời hứa cho GPU của bạn.
Model card không công bố bảng benchmark nào đứng sau tuyên bố về khả năng làm theo chỉ dẫn. Bài viết liên quan của chúng tôi, MiniMax H3-Image vs Nano Banana 2.1, đặt hai mô hình cạnh nhau để so sánh.
Bên trong mô hình có gì
Model card mô tả kiến trúc một cách chi tiết khác thường:
- Diffusion transformer: 33,1 tỷ tham số, transformer single-stream dạng dense với 50 lớp, lưu ở BF16 (68,65 GB).
- Text encoder: text encoder MiniMax-H3, không thay đổi, tải từ repository MiniMax-H3 riêng (66,7 GB).
- Image VAE: downsampling không gian 16x và 24 kênh latent (2,34 GB).
- Prompt expander tùy chọn: MiniMax-H3-Image-PE (17,9 GB, NVFP4), chuyển prompt ngắn thành mô tả tiếng Anh chi tiết mà mô hình mong đợi.
Cộng tất cả lại, một bộ cục bộ đầy đủ sẽ tải xuống khoảng 137 GB, chưa tính prompt expander tùy chọn.
"Open-weight" với MiniMax H3-Image nghĩa là gì
MiniMax H3-Image là open-weight, không phải open-source theo nghĩa của OSI. Bạn có thể tải và chạy weights, nhưng MiniMax-H3-Image Community License đặt ra những giới hạn thực tế. Hãy đọc kỹ trước khi xây dựng trên đó. Những điểm ảnh hưởng đến đa số nhóm phát triển:
- Lãnh thổ. Giấy phép cấp quyền trên toàn thế giới trừ các "Excluded Territories" (Lãnh thổ loại trừ): Liên minh Châu Âu, Vương quốc Anh, Hàn Quốc và Hoa Kỳ. Các nhóm ở đó cần liên hệ MiniMax về giấy phép riêng.
- Doanh thu và dịch vụ lưu trữ. Bạn cần sự cho phép bằng văn bản trước từ MiniMax nếu bạn và các công ty liên kết có doanh thu thường niên vượt 1 triệu đô la, hoặc nếu bạn cung cấp mô hình dưới dạng dịch vụ lưu trữ cho bên thứ ba. Yêu cầu được gửi qua bảng điều khiển giấy phép của MiniMax.
- Ghi nguồn. Sản phẩm thương mại phải hiển thị "MiniMax-H3-Image" nổi bật trong giao diện người dùng.
- Không huấn luyện mô hình khác. Bạn không được dùng mô hình hoặc đầu ra của nó để cải thiện bất kỳ mô hình AI nào khác.
- Công khai thông tin. Chính sách sử dụng hợp lý cấm công khai nội dung được tạo mà không rõ ràng tiết lộ rằng đó là nội dung do máy tạo ra.
MiniMax không yêu cầu bất kỳ quyền nào đối với ảnh bạn tạo. Nếu bạn chỉ gọi API lưu trữ, hãy đọc thêm các điều khoản nền tảng của MiniMax cho mục đích sử dụng đó.
Bạn có thể dùng MiniMax H3-Image ở đâu
Bạn có bốn con đường:
- MiniMax API. Text-to-image tại
POST https://api.minimax.io/v1/images/generationsvà chỉnh sửa tại/v1/images/edits, cả hai dùng model IDMiniMax-H3-Imagehoặc nhanh hơn làMiniMax-H3-Image-Highspeed. Hướng dẫn đầy đủ nằm trong hướng dẫn MiniMax H3-Image API của chúng tôi. - Hailuo AI. Web app của MiniMax, không cần viết code.
- MiniMax Code. Desktop app của MiniMax cho macOS và Windows, được nêu trong bài đăng ra mắt như một nơi để dùng H3-Image.
- Tự lưu trữ. MiniMax khuyến nghị SGLang, vLLM-Omni, diffusers hoặc ComfyUI, và liệt kê NVIDIA H200, RTX PRO 6000 Blackwell và AMD Instinct MI350X trong số các bộ tăng tốc được hỗ trợ. Model card không nêu dung lượng VRAM tối thiểu.
Nếu bạn đang tìm các cách dùng miễn phí, bài viết MiniMax H3-Image miễn phí có đề cập đến chúng.
MiniMax H3-Image API hoạt động thế nào
API tuân theo cấu trúc images kiểu OpenAI, nên request rất ngắn gọn:
curl https://api.minimax.io/v1/images/generations \
-H "Authorization: Bearer $MINIMAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3-Image",
"prompt": "An orange cat on a sunny windowsill, film texture",
"aspect_ratio": "16:9",
"area": "4K",
"response_format": "url"
}'
Các tham số đáng biết, từ tài liệu tham khảo API:
sizenhậnWIDTHxHEIGHT(655.360 đến 20.000.000 pixel, tỷ lệ khung hình từ 1:3 đến 3:1) hoặcauto. Vớiauto, bạn đặtaspect_ratiovàarea(1K,2Khoặc4K, mặc định4K) thay thế. Trộn hai dạng sẽ trả về lỗi 400.nyêu cầu từ 1 đến 10 ảnh mỗi request.output_formatmặc định làjpeg, hoặcpnghaywebp.response_formatlàurl(tự tải xuống, vì URL không được đảm bảo tồn tại lâu) hoặcb64_json.stream: trueđẩy từng ảnh qua server-sent events ngay khi hoàn tất.- Tăng cường prompt được bật mặc định. Mỗi kết quả chứa
revised_promptcho thấy mô hình thực sự dùng prompt gì. Đặtdisable_prompt_enhanced: trueđể gửi prompt nguyên bản.
Một hành vi dễ gây nhầm lẫn: nếu ít nhất một ảnh thành công, call sẽ trả về HTTP 200 ngay cả khi các ảnh khác không qua được kiểm tra an toàn nội dung. Hãy kiểm tra data[].error trên từng mục. Chỉ những ảnh thành công mới bị tính phí.
Hướng dẫn cũng liệt kê những gì không được hỗ trợ: ảnh xem trước, chỉnh sửa có mask và nền trong suốt.
Để chỉnh sửa, bạn truyền 1 đến 16 ảnh tham chiếu dưới dạng URL công khai, file ID đã tải lên hoặc data URI, tổng dung lượng tối đa 64 MiB mỗi request. Prompt của bạn tham chiếu chúng bằng <Picture 1>, <Picture 2> v.v., theo thứ tự tải lên.
Giá MiniMax H3-Image và khuyến mãi tuần ra mắt
MiniMax tính phí H3-Image theo triệu token, chia thành văn bản đầu vào, ảnh đầu vào và ảnh đầu ra. Theo trang giá của MiniMax, kiểm tra ngày 11 tháng 11 năm 2026:
| Mô hình | Text đầu vào / M token | Ảnh đầu vào / M token | Ảnh đầu ra / M token |
|---|---|---|---|
| MiniMax-H3-Image | $2,30 | $1,50 | $3,80 |
| MiniMax-H3-Image-Highspeed | $2,30 | $3,00 | $7,60 |
Ví dụ chi phí của chính MiniMax cho mỗi kết quả text-to-image trên mô hình tiêu chuẩn là $0,02179 ở 1K, $0,02333 ở 2K và $0,06879 ở 4K. Ví dụ Highspeed 4K là $0,13001.
Khuyến mãi ra mắt giảm 50% tổng chi phí request trên cả hai mô hình khi ảnh hoàn thành có ít nhất 16.600.000 pixel. Ưu đãi kéo dài đến 16:00 UTC ngày 17 tháng 11 năm 2026. Trong khoảng thời gian đó, MiniMax niêm yết kết quả text-to-image 4K tiêu chuẩn ở mức $0,03439 và Highspeed ở mức $0,06501. Ảnh nhỏ hơn không đủ điều kiện, nên render 2K vẫn có giá như trước.
Kiểm thử MiniMax H3-Image API với Apidog CLI
Trước khi tích hợp H3-Image vào ứng dụng, hãy chứng minh cấu trúc request, xác thực và xử lý lỗi hoạt động đúng, bao gồm cả trường hợp "200 với mục thất bại". Hãy để coding agent của bạn xây dựng và chạy bước kiểm tra đó bằng Apidog CLI thay vì click thủ công qua từng request.
![Workflow diagram: a coding agent uses Apidog CLI to create an endpoint and test case, calls POST /v1/images/generations on MiniMax H3-Image, reads a test report checking status 200, data[0].url and no data[].error, then fixes and reruns](https://assets.apidog.com/blog-next/2026/11/minimax-h3-apidog-loop.png)
Cài đặt CLI một lần:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
Skill này dạy agent của bạn (Claude Code, Codex, Cursor hoặc agent khác) các lệnh của CLI. Sau đó chỉ cần đưa cho nó một prompt:
In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.
Agent sẽ biến prompt đó thành một loạt lệnh apidog ngắn. Mọi flag dưới đây lấy từ apidog <command> --help trên Apidog CLI 2.2.12:
apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json
cli-schema get cung cấp cho agent cấu trúc JSON chính xác, và cli-schema validate kiểm tra từng file trước khi bất cứ thứ gì được ghi. test-case category cấp cho nó một category ID hợp lệ để test case hiển thị trong ứng dụng. Lần chạy sẽ in ra tóm tắt đạt/không đạt trong terminal và ghi báo cáo JSON mà agent đọc để quyết định cần sửa gì. Thêm --upload-report để xem lại lần chạy đó trong Apidog.
Dùng area: 1K giúp mỗi lệnh kiểm thử giữ ở mức giá ví dụ thấp nhất mà MiniMax niêm yết. Để tìm hiểu thêm về pattern này, xem quy trình làm việc Apidog CLI agent và Apidog CLI trong Claude Code. Gói Free của Apidog hỗ trợ tối đa 4 người dùng.
Bạn có nên thử MiniMax H3-Image?
Hãy thử nếu bạn cần ảnh lớn, chi tiết và muốn một lựa chọn open-weight, hoặc nếu chỉnh sửa đa tham chiếu (ảnh sản phẩm, bố cục phòng, character sheet) là use case của bạn. Khuyến mãi ra mắt giúp các thử nghiệm 4K trở nên rẻ hơn cho đến ngày 17 tháng 11.
Cân nhắc kỹ trước khi tự lưu trữ: khoảng 137 GB weights, GPU data-center và một giấy phép loại trừ EU, Vương quốc Anh, Hàn Quốc và Hoa Kỳ. Với đa số nhóm, API là con đường thực tế. Nếu bạn đang so sánh các API hình ảnh, các hướng dẫn của chúng tôi về GPT Image 2.6 API, Nano Banana 2.1 API và Qwen-Image 2.1 bao quát các phương án thay thế.
Câu hỏi thường gặp
MiniMax H3-Image có miễn phí không? Weights được tải xuống và chạy miễn phí bản quyền trong phạm vi lãnh thổ của giấy phép, tuân theo các giới hạn về doanh thu và lưu trữ. API tính phí theo token. Xem hướng dẫn truy cập miễn phí của chúng tôi để biết các cách dùng không mất phí.
MiniMax H3-Image có phải open-source không? MiniMax gọi nó là open-source trên Hugging Face, nhưng nó phát hành theo giấy phép cộng đồng tùy chỉnh với các hạn chế về lãnh thổ, doanh thu, ghi nguồn và cấm huấn luyện. "Open-weight" là thuật ngữ chính xác hơn.
MiniMax H3-Image nhanh đến mức nào? MiniMax cho biết một ảnh 4K mất khoảng 10 giây. Đó là con số của công ty; họ không nêu phần cứng, và tại thời điểm viết bài chưa có benchmark độc lập nào.
MiniMax-H3-Image khác gì với MiniMax-H3-Image-Highspeed? Cả hai nhận cùng tham số và giới hạn. Highspeed là cấp tốc độ nhanh hơn và đắt hơn: $7,60 mỗi triệu token ảnh đầu ra so với $3,80.
MiniMax H3-Image có thể dùng bao nhiêu ảnh tham chiếu? Tối đa 16 ảnh mỗi request chỉnh sửa, mỗi ảnh từ 128 đến 8.192 pixel mỗi cạnh, với toàn bộ request body giới hạn ở 64 MiB.
Khuyến mãi ra mắt MiniMax H3-Image kết thúc khi nào? 16:00 UTC ngày 17 tháng 11 năm 2026. Ưu đãi chỉ áp dụng cho ảnh có ít nhất 16.600.000 pixel.