MiniMax H3 Max Turbo

Tạo video 5–15 giây ở 480P hoặc 768P từ văn bản hay khung hình đầu và cuối. Trường yêu cầu, giới hạn ảnh, giá tính theo giây đầu ra và truy vấn tác vụ.

MiniMax H3 Max Turbo tạo video ngắn từ văn bản hoặc ảnh khung hình. Dùng ID mô hình minimax-h3-max-turbo, giữ ID tác vụ trả về và truy vấn để lấy video hoàn tất. Trang này mô tả giao diện gốc với mảng content được cung cấp trên SeedRouter.

ID mô hình

ID mô hình	Đầu vào	Độ phân giải	Độ dài
`minimax-h3-max-turbo`	văn bản, khung hình đầu, khung hình cuối tùy chọn	480P, 768P	5–15 giây

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-turbo",
    "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

Header	Giá trị
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

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ố

Trường	Kiểu	Mặc định	Ghi chú
`model`	string	bắt buộc	`minimax-h3-max-turbo`
`content`	array	bắt buộc	Prompt và mọi media, dưới dạng các mục mô tả bên dưới. Đúng một mục `text` không rỗng.
`resolution`	enum	bắt buộc	`480P` hoặc `768P`.
`duration`	integer	bắt buộc	Số nguyên bất kỳ từ 5 đến 15 giây.
`ratio`	enum	theo đầu vào	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Bắt buộc khi chỉ có văn bản, và khi đó không chấp nhận `adaptive`.
`extra`	object	không gửi	Thiết lập mở rộng prompt không bắt buộc.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled`, `balanced` hoặc `quality`. Bỏ đối tượng hoặc thuộc tính để giữ mặc định của mô hình.
`content_filter`	boolean	`true`	Bộ lọc nội dung của SeedRouter, mô tả bên dưới. Không gửi tới mô hình.

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

`type`	Mục	`role`
`text`	`{"type":"text","text":"..."}`, tối đa 7.000 ký tự	không có
`image_url`	`{"type":"image_url","image_url":{"url":"https://..."},"role":"first_frame"}`	`first_frame` hoặc `last_frame`

Cần đúng một mục văn bản không rỗng. Một ảnh duy nhất không có role được coi là khung hình đầu. Chấp nhận tối đa một khung hình đầu và một khung hình cuối; khung hình cuối cần khung hình đầu. Không hỗ trợ ảnh, video và âm thanh tham chiếu.

Các chế độ

Các mục trong content quyết định chế độ; không gửi trường mode.

Chế độ	Nội dung	Tỷ lệ
Văn bản thành video	một mục văn bản	bắt buộc; một trong sáu tỷ lệ cụ thể, không bao giờ là `adaptive`
Ảnh thành video	văn bản và khung hình đầu, có thể thêm khung hình cuối	theo ảnh khung hình; giá trị hợp lệ khác không có tác dụng

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Ảnh khung hình

Dùng URL HTTP(S) công khai không nhúng thông tin đăng nhập. Không chấp nhận Base64 và ID mm_file://. Ảnh có thể là JPG, JPEG, PNG, WebP, HEIC hoặc HEIF, mỗi ảnh tối đa 30 MB, mỗi cạnh 256–5760 pixel và rộng/cao từ 0,4 đến 2,5. Đầu vào được kiểm tra trước khi tạo. Dùng bố cục và tỷ lệ khung hình tương thích cho hai khung hình.

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í

Phần giá mô hình hiển thị mức giá hiện tại. Turbo có một khoản phí: giây đầu ra ở độ phân giải đã chọn. Khung hình đầu, cuối và mở rộng prompt không có phí riêng.

cost = reported output seconds × output-second rate for the resolution

Ước tính dùng số giây nguyên được yêu cầu. Thanh toán cuối cùng dùng số giây đầu ra của tác vụ hoàn tất theo mức giá đã ghi nhận cho yêu cầu. Nếu không có lượng sử dụng hợp lệ, ước tính đã chấp nhận được áp dụng. Thời lượng container media có thể khác đôi chút với số giây tính phí. 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-turbo", "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-turbo",
  "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-turbo",
  "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ả một chủ thể, hành động, chuyển động máy quay và thiết lập ánh sáng cho mỗi cảnh quay.
Dùng 480P cho bản nháp và 768P để có thêm chi tiết đầu ra. Mỗi lần tạo mới là một yêu cầu trả phí riêng.
Cung cấp khung hình đầu để xác lập bố cục mở đầu; chỉ thêm khung hình cuối khi có cả khung hình đầu.
Dùng extra.prompt_expansion_mode để chọn disabled, balanced hoặc quality; bỏ qua sẽ giữ balanced.
Kiểm tra toàn bộ clip và âm thanh trước khi xuất bản. Prompt không bảo đảm hình học sản phẩm hay chữ chính xác.

Liên quan

Phạm vi hợp đồng tham số

Giao diện này dùng định dạng yêu cầu mảng content của MiniMax với ID mô hình SeedRouter, tác vụ bất đồng bộ, ảnh 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à kiểm tra đầu vào của SeedRouter, không phải tham số MiniMax.

Giao diện riêng được lưu trữ trên fal có trường và giới hạn khác; 1080P, thời lượng giây lẻ, tùy chọn âm thanh đích và tham chiếu theo thứ tự của nó không áp dụng ở đây. Giao diện này không nhận tùy chọn seed và watermark. Xem hướng dẫn so sánh để hiểu khác biệt và các nguồn liên kết.

On this page