API MiniMax H3

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video MiniMax H3.

Các biến thể mô hình

API này hỗ trợ ba biến thể mô hình:

So sánh nhanh

Tỷ lệ khung hình được hỗ trợ

Văn bản thành video và Nội dung tham chiếu thành video hỗ trợ:

21:9, 16:9, 4:3, 1:1, 3:4, 9:16

Tùy chọn độ phân giải

MiniMax H3 Văn bản thành video

Điểm cuối

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Yêu cầu mẫu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'minimax-h3-text-to-video',
    prompt: 'Một chú chó golden retriever chạy qua đồng cỏ ngập nắng',
    duration: 8,
    resolution: '2k',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

MiniMax H3 Hình ảnh thành video

Điểm cuối

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Tùy chọn

Lưu ý: Hình ảnh thành video không hỗ trợ aspect_ratio.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'minimax-h3-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'Máy quay từ từ lùi lại để hé lộ toàn bộ phong cảnh',
  duration: 8,
  resolution: '2k'
}

MiniMax H3 Nội dung tham chiếu thành video

Tạo video mới từ hình ảnh, video và âm thanh tham chiếu tùy chọn.

Điểm cuối

POST /api/v1/video/task

Tham số yêu cầu

Bắt buộc

Phương tiện tham chiếu

Phần giữ chỗ tham chiếu @ (AT)

Tính năng tham chiếu @ (AT) liên kết phương tiện tham chiếu với câu lệnh thông qua các phần giữ chỗ <<<...>>> được đánh số. Số thứ tự bắt đầu độc lập từ 1 cho từng loại phương tiện và tuân theo thứ tự của mảng tương ứng.

Ví dụ: nếu hình ảnh đầu tiên là hình ảnh tham chiếu nhân vật và hình ảnh thứ hai là hình ảnh tham chiếu bối cảnh, hãy dùng <<<image_1>>> cho nhân vật và <<<image_2>>> cho bối cảnh trong prompt. Mỗi phần giữ chỗ phải trỏ đến một mục tồn tại trong mảng tương ứng.

Yêu cầu mẫu

javascriptSao chép
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'Sử dụng hình ảnh một cho chủ thể, video một cho chuyển động và âm thanh một cho bầu không khí',
  duration: 8,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

Ví dụ yêu cầu Nội dung tham chiếu thành video bằng @ (AT)

javascriptSao chép
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'Đặt nhà thám hiểm từ <<<image_1>>> vào môi trường từ <<<image_2>>>, đi theo chuyển động máy quay trong <<<video_1>>> và nói bằng giọng nói tham chiếu từ <<<audio_1>>>',
  duration: 10,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.jpg'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

Định dạng phản hồi

Phản hồi ban đầu

Tất cả các mô hình đều trả về task_id để thăm dò:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Phản hồi thăm dò

Thăm dò GET /api/v1/video/{taskId} để kiểm tra trạng thái:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Giá trị trạng thái

• submitted: Tác vụ đã được chấp nhận và đang chờ xử lý
• processing: Đang tiến hành tạo video
• succeed: Đã hoàn tất tạo video
• failed: Tạo video thất bại

Phương pháp hay nhất

1. Mô tả chuyển động rõ ràng: Bao gồm mô tả chuyển động cụ thể trong câu lệnh
2. Lựa chọn độ phân giải: Sử dụng 768p để xử lý nhanh hơn, 2k để có đầu ra chất lượng cao hơn
3. Chất lượng hình ảnh: Khi tạo video từ hình ảnh, hãy sử dụng hình ảnh đầu vào chất lượng cao để đạt kết quả tốt nhất
4. Thứ tự tham chiếu: Giữ images, videos và audios theo thứ tự có chủ đích và tham chiếu đến chúng một cách nhất quán trong câu lệnh
5. Tham chiếu @ (AT): Sử dụng các phần giữ chỗ <<<image_N>>>, <<<video_N>>> và <<<audio_N>>> khi bạn cần kiểm soát rõ ràng tài nguyên tham chiếu nào định hướng từng phần của cảnh