MiniMax-H3 API

Sử dụng ID mẫu chính xác MiniMax-H3. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫuMiniMax-H3POST /v1/videos5.2s

Thông số: duration=5resolution=2Kratio=16:9

Câu lệnh: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Yêu cầu tạo ra mẫu này

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo nhiệm vụ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Thăm dò ý kiến và tải xuống

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ghi chú yêu cầu

MiniMax-H3 sử dụng content[] với đầu ra điều khiển resolution, duration và ratio.

Tham số yêu cầu

MiniMax-H3 sử dụng mảng content[] đa phương thức. Thăm dò đường dẫn truy vấn MiniMax sau khi tạo tác vụ; Vai trò first_frame / last_frame và reference_* là các quy trình công việc riêng biệt.

Cánh đồng	Bắt buộc	Ghi chú
model	Có	MiniMax-H3
content[]	Có	Chính xác một mục text; có thể bao gồm first_frame, last_frame, reference_image, reference_video hoặc reference_audio
resolution	Có	768P / 2K
duration	Có	4–15 giây
ratio	Có điều kiện	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Có điều kiện	Sử dụng first_frame / last_frame cho hình ảnh thành video và reference_* cho quy trình làm việc tham khảo; không trộn lẫn các nhóm
content[].url	Không	Yêu cầu URL HTTP/HTTPS công khai; Phương tiện Base64 không được hỗ trợ
aigc_watermark	Không	Có nên thêm hình mờ hay không
callback_url	Không	URL gọi lại trạng thái nhiệm vụ

Giới hạn đầu vào và đầu ra

Đầu ra là 768P hoặc 2K trong 4–15 giây. Yêu cầu chỉ có văn bản cần có ratio cụ thể; tính năng chuyển hình ảnh thành video cho phép một khung hình đầu tiên và một khung hình cuối cùng, trong khi quy trình làm việc tham chiếu yêu cầu ít nhất một hình ảnh hoặc video tham chiếu và không thể chỉ sử dụng âm thanh. Không trộn lẫn hai nhóm vai trò.

Ví dụ về quy trình làm việc được ghi lại

MiniMax-H3 phải có thể truy cập công khai và không thể sử dụng Base64; Không được trộn lẫn quy trình công việc đầu tiên/khung cuối và tham chiếu.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Lỗi và tác vụ không thành công

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng tính phí video theo giây. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.

Các biến thể

ID mẫu	Sự khác biệt
MiniMax-H3	Mô hình được ghi lại trên trang này.