MiniMax-H3API

Gunakan ID model yang tepat MiniMax-H3. Bidang model harus sama persis dengan halaman ini.

Contoh keluaranMiniMax-H3POST /v1/videos5.2s

Parameter: duration=5resolution=2Kratio=16:9

Prompt: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Buat tugas

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Poll and download

Simpan ID tugas. Jajak pendapat GET /v1/videos/{task_id} dan unduh dengan GET /v1/videos/{task_id}/content. URL hasil mungkin kedaluwarsa, jadi segera transfer file.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Minta catatan

MiniMax-H3 menggunakan content[] dengan output pengontrol resolution, duration, dan ratio.

Parameter permintaan

MiniMax-H3 menggunakan array multimodal content[]. Lakukan polling jalur kueri MiniMax setelah pembuatan tugas; Peran first_frame / last_frame dan reference_* adalah alur kerja yang berbeda.

Bidang	Wajib diisi	Catatan
model	Ya	MiniMax-H3
content[]	Ya	Tepat satu item text; mungkin termasuk first_frame, last_frame, reference_image, reference_video, atau reference_audio
resolution	Ya	768P / 2K
duration	Ya	4–15 detik
ratio	Bersyarat	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Bersyarat	Gunakan first_frame / last_frame untuk gambar-ke-video dan reference_* untuk alur kerja referensi; jangan campur kelompok
content[].url	Tidak	URL HTTP/HTTPS publik diperlukan; Media Base64 tidak didukung
aigc_watermark	Tidak	Apakah akan menambahkan tanda air
callback_url	Tidak	URL panggilan balik status tugas

Batas masukan dan keluaran

Outputnya adalah 768P atau 2K selama 4–15 detik. Permintaan hanya teks memerlukan ratio yang konkret; image-to-video memungkinkan satu frame pertama dan satu frame terakhir, sedangkan alur kerja referensi memerlukan setidaknya satu gambar atau video referensi dan tidak dapat menggunakan audio saja. Jangan mencampurkan kedua kelompok peran tersebut.

Contoh alur kerja yang terdokumentasi

MiniMax-H3 URL media harus dapat diakses publik dan tidak dapat menggunakan Base64; alur kerja bingkai pertama/akhir dan referensi tidak boleh dicampur.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Kesalahan dan tugas yang gagal

Parameter model yang tidak valid menampilkan 4xx dengan ID permintaan. Tugas asinkron juga bisa gagal masuk setelah pembuatan berhasil; gunakan error_code dan error_message dari respon polling sebagai alasan tugas akhir. Jangan coba lagi permintaan yang sama dengan bentuk JSON yang berbeda.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan video per detik. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.

Varian

ID Model	Perbedaan
MiniMax-H3	Model didokumentasikan di halaman ini.