MiniMax H3 Max

MiniMax H3 Max là biến thể tạo nhanh hơn của MiniMax H3. Một yêu cầu tạo cả hình ảnh và âm thanh: clip 5–15 giây ở 480P hoặc 768P với hội thoại, âm nền và hiệu ứng riêng. Phần thân yêu cầu theo định dạng chính thức của MiniMax với ID mô hình minimax-h3-max. Gửi yêu cầu, giữ ID tác vụ trả về và lấy video hoàn tất từ tác vụ. Khung hình và tham chiếu được gửi dưới dạng URL.

ID mô hình

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn tất. Truy vấn GET /v1/tasks/{task_id} để nhận kết quả. Giữ khóa API trong mã phía máy chủ.

Tham số

Lược đồ nghiêm ngặt: trường không xác định bị từ chối thay vì bỏ qua. Không có callback_url; hãy truy vấn tác vụ. extra là đối tượng nghiêm ngặt không bắt buộc, chỉ chứa prompt_expansion_mode. Mọi trường đều từ chối null; hãy bỏ các trường không bắt buộc thay vì gửi null.

Các mục content

Một ảnh duy nhất không có role được coi là khung hình đầu. Khi có nhiều ảnh, mỗi ảnh cần có role.

Các chế độ

Các mục trong content quyết định chế độ; không có trường chế độ riêng.

Không thể kết hợp khung hình và tham chiếu trong một yêu cầu. Tài liệu chính thức có liệt kê đầu vào chỉ có khung hình cuối, nhưng cũng có yêu cầu mâu thuẫn là phải ghép với khung hình đầu. Trường hợp đó chưa được xác minh trên SeedRouter. Dùng cả hai khung hình khi cần ảnh kết thúc.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

Đầu vào media

Mỗi mục ảnh, video và âm thanh là URL HTTP(S) công khai. Không chấp nhận data URI Base64 và ID mm_file://: tải tệp lên kho lưu trữ của bạn và truyền URL.

Video tham chiếu được đo khi yêu cầu được tiếp nhận; video không đọc được độ dài sẽ bị từ chối và không tính phí. Các giới hạn khác được kiểm tra trước khi tạo; yêu cầu vi phạm sẽ thất bại không mất phí.

Bộ lọc nội dung

content_filter là true trừ khi bạn đặt khác đi. Khi bật bộ lọc, yêu cầu cùng văn bản và media được kiểm duyệt trước khi tạo. Yêu cầu bị gắn cờ thất bại với mã 60001 và không bị tính phí. Đặt content_filter thành false để bỏ qua kiểm duyệt; Playground trên website luôn bật bộ lọc.

Các yếu tố chi phí

Kiểm tra phần giá mô hình để biết mức giá hiện tại. MiniMax H3 Max tính riêng giây đầu ra được tạo và giây video tham chiếu, theo độ phân giải đầu ra. Hai ảnh đầu miễn phí; mỗi ảnh tiếp theo thêm phí.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

Độ dài video tham chiếu được cộng lại rồi làm tròn đến giây nguyên gần nhất khi tính lượng sử dụng cuối cùng. Vì vậy hai clip 2,4 giây đóng góp năm giây đầu vào. Âm thanh tham chiếu không có phí đầu vào. Khung hình đầu và cuối được tính là ảnh, nên chỉ hai khung hình không thêm phí ảnh.

Ước tính Playground làm tròn độ dài video tham chiếu lên để bao quát khoản phí cuối cùng có thể có. Lượng sử dụng cuối cùng được tính theo mức giá đã ghi nhận cho yêu cầu. Nếu không có báo cáo sử dụng đầy đủ, ước tính đã chấp nhận được áp dụng. Xem phí trong lịch sử sử dụng tài khoản; phản hồi tác vụ công khai không có phí. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Gửi yêu cầu sẽ trả về tác vụ:

{"id": "task_...", "model": "minimax-h3-max", "status": "processing", "created_at": 1789689600}

Lấy thông tin tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Truy vấn mỗi 10–20 giây cho đến khi status là completed hoặc failed. Hết thời gian chờ mạng khi truy vấn không có nghĩa là tạo thất bại: giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ mới để kiểm tra tiến độ.

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio là tỷ lệ khung hình mà clip được tạo, kể cả tỷ lệ được chọn cho adaptive. Tác vụ chứa độ phân giải, tỷ lệ và thời lượng thực tế khi được báo cáo. JSON ở trên minh họa cấu trúc phản hồi; không phải kết quả tạo đã đo lường.

Lỗi

Yêu cầu bị từ chối trước khi tạo tác vụ trả về lỗi HTTP với đối tượng error và không bị tính phí. Tác vụ thất bại sau khi tiếp nhận trả về HTTP 200 khi được truy vấn, với status: "failed" và đối tượng error.

Xem danh mục lỗi chung để biết mã, trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Nếu chính lần gửi hết thời gian chờ, kiểm tra tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

• Mô tả cảnh quay và âm thanh cùng nhau: chủ thể, địa điểm, máy quay, ánh sáng, hội thoại và hiệu ứng.
• Viết hội thoại vào prompt và đính kèm âm thanh tham chiếu khi giọng nói cần theo đoạn đó.
• Tạo bản nháp ở 480P, rồi chọn 768P khi cần thêm chi tiết. Mỗi lần render mới là yêu cầu trả phí riêng.
• Dùng extra: {"prompt_expansion_mode": "disabled"} cho prompt đã hoàn chỉnh, hoặc chọn mở rộng balanced / quality.
• Dùng khung hình đầu và cuối để kiểm soát nơi cảnh quay bắt đầu, kết thúc; dùng tham chiếu để giữ sản phẩm, nhân vật hoặc chuyển động.
• Thêm no text, no logos để tránh các dấu hiệu bị bịa ra.

Liên quan

• Playground và giá MiniMax H3 Max
• Tải OpenAPI
• Markdown có thể sao chép

Nguồn hợp đồng tham số

Tham số tuân theo tài liệu tạo video MiniMax. SeedRouter dùng ID mô hình riêng và giao diện tác vụ bất đồng bộ, media chỉ qua URL và giao kết quả được lưu trữ; không có callback hay hủy tác vụ. content_filter là phần mở rộng của SeedRouter.