Claude Opus 5.5 đã có trên SeedRouter

Video

MiniMax H3

View Markdown

Tạo clip 4–15 giây có âm thanh ở 768P hoặc 2K bằng MiniMax H3: văn bản thành video, khung hình đầu và cuối, và tham chiếu thành video, theo định dạng yêu cầu chính thức của MiniMax, giao kết quả qua tác vụ.

Standard và Pro

Cả hai kênh đều hỗ trợ content_filter. Mặc định là true và nội dung được kiểm tra trước khi tạo. Playground luôn bật tùy chọn này; người gọi API có thể đặt thành false. Các hạn chế nội dung từ nhà cung cấp vẫn có thể áp dụng.

minimax-h3 là Pro và giữ nguyên định dạng yêu cầu cùng hành vi hiện có. Các phần về định dạng gốc bên dưới mô tả Pro. Standard dùng minimax-h3-standard với phần thân JSON phẳng riêng tại cùng endpoint /v1/videos/generations. Đây không phải phiên bản Max hay Turbo. Hai biến thể không tự động chuyển sang nhau khi gặp lỗi.

{
  "model": "minimax-h3-standard",
  "prompt": "A sailboat crosses a quiet bay, with soft wind and waves.",
  "quality": "high",
  "content_filter": true,
  "duration_s": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}

Standard chỉ chấp nhận các trường sau. URL phải là địa chỉ HTTP(S) công khai, không chứa thông tin xác thực; không chấp nhận tải tệp trực tiếp hoặc base64.

TrườngKiểuBắt buộc / mặc địnhGiá trị
modelstringbắt buộcminimax-h3-standard
promptstringbắt buộckhông rỗng; bắt buộc ở mọi chế độ
qualitystringbắt buộclow, high; cùng giá
duration_snumber55–15, bao gồm số thập phân
resolutionstring768p480p, 768p, 1080p, 2k, 4k
aspect_ratiostring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9
seedintegerngẫu nhiên0–9223372036854775807
watermarkbooleanfalsetrue / false
enhancebooleantrueviết lại prompt; false giữ nguyên prompt
priorityinteger10001000 / 0
content_filterbooleantrueSeedRouter kiểm tra nội dung trước khi tạo; false bỏ qua kiểm tra
first_frame_image_urlstringtùy chọnmột URL ảnh
last_frame_image_urlstringtùy chọnyêu cầu khung hình đầu
reference_image_urlstring[]tùy chọn1–4 URL ảnh
reference_video_urlstring[]tùy chọnmột URL video

Không thể kết hợp khung hình đầu/cuối với tham chiếu. Không có media nghĩa là tạo video từ văn bản. Có thể kết hợp ảnh tham chiếu với một video tham chiếu. Không hỗ trợ âm thanh tham chiếu độc lập. Mọi đầu ra đều có âm thanh gốc. Low ưu tiên tốc độ, High ưu tiên độ trung thực, nhưng không khẳng định mức nào có chất lượng tương đương Pro.

Ảnh: tối đa 30 MiB mỗi ảnh; JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF hoặc AVIF. Không giới hạn kích thước ảnh; ảnh lớn có thể được thu nhỏ trước khi tạo. Video: tối đa 100 MiB, 0.5–600 giây, có luồng video đọc được (bao gồm MP4, MOV và WebM), chiều rộng và chiều cao là số chẵn, mỗi chiều ít nhất 64 pixel.

Standard tính phí theo ceil(duration_s) × đơn giá hiện tại của độ phân giải. Media tham chiếu, âm thanh, chất lượng và việc viết lại prompt không làm tăng phí. Tác vụ thất bại không bị tính phí. Giá được lấy từ phần giá hiện tại.

Việc tạo và thăm dò trạng thái sử dụng giao thức bất đồng bộ chung bên dưới. Đầu ra thành công có video_url, resolution, ratio và duration; duration phản ánh thời lượng đã yêu cầu. Không trả về phí, mã nhận dạng hoặc URL của nhà cung cấp. Không tự động gửi lại khi chưa rõ kết quả gửi yêu cầu. Với seed vượt giới hạn số nguyên an toàn của JavaScript, hãy tuần tự hóa số nguyên mà không mất độ chính xác; không làm tròn qua Number.

Tài liệu tham khảo Pro

MiniMax H3 (Hailuo 03) là mô hình video đa phương thức của MiniMax. Một yêu cầu tạo hình ảnh và âm thanh cùng lúc: một clip 4–15 giây ở 768P hoặc 2K có sẵn lời thoại, âm thanh nền và hiệu ứ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. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc video hoàn chỉnh từ tác vụ. Khung hình và tham chiếu được truyền vào dưới dạng URL.

ID mô hình

ID mô hìnhĐầu vàoĐộ phân giảiĐộ dài
minimax-h3văn bản, khung hình đầu và cuối, ảnh, video và âm thanh tham chiếu768P, 2K4–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",
    "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
HeaderGiá trị
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

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

Tham số

TrườngKiểuMặc địnhGhi chú
modelstringbắt buộcminimax-h3
contentarraybắt buộcPrompt 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.
resolutionenumbắt buộc768P hoặc 2K.
durationintegerbắt buộcSố nguyên bất kỳ từ 4 đến 15 giây.
ratioenumtheo đầu vàoadaptive, 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.
content_filterbooleantrueBộ lọc nội dung của SeedRouter, mô tả bên dưới. Không được gửi tới mô hình.

Lược đồ được kiểm tra chặt chẽ: trường không xác định sẽ bị từ chối chứ không bị bỏ qua. Không hỗ trợ callback_url; hãy truy vấn tác vụ thay thế. extra thuộc về MiniMax-H3-Max và không được chấp nhận cho mô hình này.

Các mục content

typeMụcrole
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, last_frame hoặc reference_image
video_url{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}reference_video
audio_url{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}reference_audio

Một ảnh duy nhất không có role được coi là khung hình đầu. Khi có nhiều hơn một ảnh, ảnh nào cũng 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.

Chế độcontent chứaratio
Văn bản thành videomột mục textbắt buộc, không phải adaptive
Ảnh thành videotext cùng một ảnh first_frame và/hoặc last_framemọi giá trị đều được coi là adaptive: ảnh quyết định khuôn hình
Tham chiếu thành videotext cùng tổ hợp bất kỳ gồm tối đa 9 mục reference_image, 3 reference_video và 3 reference_audiokhông bắt buộc, mặc định adaptive

Không thể kết hợp khung hình với tham chiếu trong cùng một yêu cầu.

{
  "model": "minimax-h3",
  "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": "2K",
  "duration": 6
}

Đầu vào media

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

Đầu vàoĐịnh dạngGiới hạn
ẢnhJPG, JPEG, PNG, WebP, HEIC, HEIFTối đa 30 MB; mỗi cạnh 256–5760 px; rộng / cao 0,4–2,5
VideoMP4, MOV (H.264 hoặc H.265)Tối đa 50 MB; mỗi video 2–15 giây, tổng cộng 15 giây; mỗi cạnh 256–5760 px; rộng / cao 0,4–2,5; 23,976–60 fps
Âm thanhWAV, MP3Tối đa 15 MB; mỗi đoạn 2–15 giây, tổng cộng 15 giây

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 bị tính phí. Các giới hạn khác được kiểm tra trước khi tạo, và yêu cầu vi phạm một giới hạn sẽ thất bại mà không bị tính phí.

Bộ lọc nội dung

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

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. MiniMax H3 tính phí theo từng giây video, với mức giá do độ phân giải đầu ra quyết định, cộng thêm các ảnh đầu vào vượt quá năm ảnh đầu tiên:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

Khung hình đầu, khung hình cuối và ảnh tham chiếu đều được tính là ảnh. Âm thanh tham chiếu không bị tính phí. Cả hai đại lượng đều được biết khi yêu cầu được tiếp nhận, nên số tiền tạm giữ chính là số tiền bị tính. Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

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

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

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

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

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "minimax-h3",
  "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. Trong thử nghiệm của chúng tôi, một clip 768P dài 4 giây ở 16:9 trả về dạng MP4 (H.264) ở 1344 × 768 và 24 fps, với rãnh âm thanh AAC stereo 32 kHz.

Lỗi

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

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

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

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các 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ủa nó cùng lúc: chủ thể, địa điểm, máy quay, ánh sáng, lời thoại và hiệu ứng.
  • Viết lời thoại vào prompt và đính kèm một đoạn âm thanh tham chiếu khi giọng nói cần theo đoạn đó.
  • Làm bản nháp ở 768P, rồi render cảnh quay cuối cùng ở 2K với cùng một yêu cầu.
  • Dùng khung hình đầu và cuối để kiểm soát điểm bắt đầu và kết thúc của cảnh quay; dùng tham chiếu để giữ một sản phẩm, một người hoặc một chuyển động.
  • Thêm no text, no logos để tránh các dấu hiệu tự bịa ra.

Liên quan