Tạo video MiniMax-H3

Sử dụng MiniMax-H3 qua API video tương thích OpenAI của APIMaster. Tác vụ tạo video chạy bất đồng bộ.

Base URL: https://apimaster.ai/v1 là https://apimaster.ai/v1. Tạo tác vụ bằng POST https://apimaster.ai/v1/video/generations.

Tương thích và kiểm tra tham số

Hỗ trợ cả POST https://apimaster.ai/v1/video/generations và POST https://apimaster.ai/v1/videos/generations. Với cùng mô hình, tham số và quy tắc tính phí giống nhau; mỗi đường dẫn giữ định dạng phản hồi tạo tác vụ hiện có. Khách hàng hiện tại không cần đổi đường dẫn.

MiniMax-H3 giữ ví dụ số ít; size và resolution, cũng như ratio và aspect_ratio, là bí danh. Giá trị không hỗ trợ hoặc bí danh mâu thuẫn trả HTTP 400, không tự chuyển sang độ phân giải cao hơn. Hãy chỉ định rõ độ phân giải, tỷ lệ và thời lượng.

Tạo tác vụ

Trường	Kiểu	Bắt buộc	Mô tả
model	string	có	MiniMax-H3
prompt	string	tùy định dạng	Mô tả video
duration	integer	không	4–15 giây, mặc định 4
size	string	không	768P hoặc 2K, mặc định 768P
ratio	string	không	Tỷ lệ khung hình, mặc định 16:9

curl -s "https://apimaster.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'

Phản hồi trả về ngay id và task_id với trạng thái queued.

Kiểm tra trạng thái

GET https://apimaster.ai/v1/videos/{task_id} trả về queued, in_progress, completed hoặc failed.

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"

Chờ 10–20 giây sau khi gửi, sau đó kiểm tra mỗi 3–5 giây.

Tải video

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

Chỉ tải MP4 khi trạng thái là completed. duration hỗ trợ 4–15 giây và size hỗ trợ 768P, 2K.

Tạo video từ tham chiếu (r2v)

Gửi mảng V2 chính thức content đến endpoint APIMaster ở trên. Phải có một mục text không rỗng; khi có content, không cần prompt ở cấp ngoài cùng. reference_image định hướng chủ thể hoặc phong cách, không cố định khung hình đầu. Trường cũ images ánh xạ hai ảnh đầu thành khung hình đầu và cuối. Không trộn các vai trò này với vai trò tham chiếu.

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
    {"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9"
}